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,75 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Хелпер для работы с каналом IPC.
|
|
3
|
+
*/
|
|
4
|
+
export default class IpcChannel {
|
|
5
|
+
/**
|
|
6
|
+
* Информация о публичных сущностях.
|
|
7
|
+
*/
|
|
8
|
+
static readonly publicInfo: {
|
|
9
|
+
/**
|
|
10
|
+
* Получить канал получения информации.
|
|
11
|
+
* @returns Канал получения информации
|
|
12
|
+
*/
|
|
13
|
+
get: () => string;
|
|
14
|
+
};
|
|
15
|
+
/**
|
|
16
|
+
* Публичная функция.
|
|
17
|
+
*/
|
|
18
|
+
static readonly func: {
|
|
19
|
+
/**
|
|
20
|
+
* Получить канал вызова функции.
|
|
21
|
+
* @param name - Имя функции.
|
|
22
|
+
* @returns Канал вызова функции.
|
|
23
|
+
*/
|
|
24
|
+
call: (name: string) => string;
|
|
25
|
+
};
|
|
26
|
+
/**
|
|
27
|
+
* Публичное событие.
|
|
28
|
+
*/
|
|
29
|
+
static readonly event: {
|
|
30
|
+
/**
|
|
31
|
+
* Получить канал отслеживания события.
|
|
32
|
+
* @returns Канал отслеживания события.
|
|
33
|
+
*/
|
|
34
|
+
on: () => string;
|
|
35
|
+
/**
|
|
36
|
+
* Получить канал однократного отслеживания события.
|
|
37
|
+
* @returns Канал однократного отслеживания события.
|
|
38
|
+
*/
|
|
39
|
+
once: () => string;
|
|
40
|
+
/**
|
|
41
|
+
* Получить канал вызова события.
|
|
42
|
+
* @param name - Название события.
|
|
43
|
+
* @returns Канал вызова события.
|
|
44
|
+
*/
|
|
45
|
+
emit: (name: string) => string;
|
|
46
|
+
};
|
|
47
|
+
/**
|
|
48
|
+
* Публичное свойство.
|
|
49
|
+
*/
|
|
50
|
+
static readonly prop: {
|
|
51
|
+
/**
|
|
52
|
+
* Получить канал получения значения свойства.
|
|
53
|
+
* @param name - Имя свойства.
|
|
54
|
+
* @returns Канал получения значения свойства.
|
|
55
|
+
*/
|
|
56
|
+
get: (name: string) => string;
|
|
57
|
+
/**
|
|
58
|
+
* Получить канал установки значения свойства.
|
|
59
|
+
* @param name - Имя свойства.
|
|
60
|
+
* @returns Канал получения установки значения свойства.
|
|
61
|
+
*/
|
|
62
|
+
set: (name: string) => string;
|
|
63
|
+
};
|
|
64
|
+
/**
|
|
65
|
+
* Обещание.
|
|
66
|
+
*/
|
|
67
|
+
static readonly promise: {
|
|
68
|
+
/**
|
|
69
|
+
* Получить канал обработки обещания.
|
|
70
|
+
* @param channel - Канал, который возвращает обещание.
|
|
71
|
+
* @returns Канал обработки обещания.
|
|
72
|
+
*/
|
|
73
|
+
get: (channel: string) => string;
|
|
74
|
+
};
|
|
75
|
+
}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
/**
|
|
4
|
+
* Хелпер для работы с каналом IPC.
|
|
5
|
+
*/
|
|
6
|
+
class IpcChannel {
|
|
7
|
+
}
|
|
8
|
+
/**
|
|
9
|
+
* Информация о публичных сущностях.
|
|
10
|
+
*/
|
|
11
|
+
IpcChannel.publicInfo = {
|
|
12
|
+
/**
|
|
13
|
+
* Получить канал получения информации.
|
|
14
|
+
* @returns Канал получения информации
|
|
15
|
+
*/
|
|
16
|
+
get: () => 'GET_PUBLIC_INFO'
|
|
17
|
+
};
|
|
18
|
+
/**
|
|
19
|
+
* Публичная функция.
|
|
20
|
+
*/
|
|
21
|
+
IpcChannel.func = {
|
|
22
|
+
/**
|
|
23
|
+
* Получить канал вызова функции.
|
|
24
|
+
* @param name - Имя функции.
|
|
25
|
+
* @returns Канал вызова функции.
|
|
26
|
+
*/
|
|
27
|
+
call: (name) => `FUNCTION_CALL_${name}`
|
|
28
|
+
};
|
|
29
|
+
/**
|
|
30
|
+
* Публичное событие.
|
|
31
|
+
*/
|
|
32
|
+
IpcChannel.event = {
|
|
33
|
+
/**
|
|
34
|
+
* Получить канал отслеживания события.
|
|
35
|
+
* @returns Канал отслеживания события.
|
|
36
|
+
*/
|
|
37
|
+
on: () => 'EVENT_ON',
|
|
38
|
+
/**
|
|
39
|
+
* Получить канал однократного отслеживания события.
|
|
40
|
+
* @returns Канал однократного отслеживания события.
|
|
41
|
+
*/
|
|
42
|
+
once: () => 'EVENT_ONCE',
|
|
43
|
+
/**
|
|
44
|
+
* Получить канал вызова события.
|
|
45
|
+
* @param name - Название события.
|
|
46
|
+
* @returns Канал вызова события.
|
|
47
|
+
*/
|
|
48
|
+
emit: (name) => `EVENT_EMIT_${name}`
|
|
49
|
+
};
|
|
50
|
+
/**
|
|
51
|
+
* Публичное свойство.
|
|
52
|
+
*/
|
|
53
|
+
IpcChannel.prop = {
|
|
54
|
+
/**
|
|
55
|
+
* Получить канал получения значения свойства.
|
|
56
|
+
* @param name - Имя свойства.
|
|
57
|
+
* @returns Канал получения значения свойства.
|
|
58
|
+
*/
|
|
59
|
+
get: (name) => `PROPERTY_GET_${name}`,
|
|
60
|
+
/**
|
|
61
|
+
* Получить канал установки значения свойства.
|
|
62
|
+
* @param name - Имя свойства.
|
|
63
|
+
* @returns Канал получения установки значения свойства.
|
|
64
|
+
*/
|
|
65
|
+
set: (name) => `PROPERTY_SET_${name}`
|
|
66
|
+
};
|
|
67
|
+
/**
|
|
68
|
+
* Обещание.
|
|
69
|
+
*/
|
|
70
|
+
IpcChannel.promise = {
|
|
71
|
+
/**
|
|
72
|
+
* Получить канал обработки обещания.
|
|
73
|
+
* @param channel - Канал, который возвращает обещание.
|
|
74
|
+
* @returns Канал обработки обещания.
|
|
75
|
+
*/
|
|
76
|
+
get: (channel) => `${channel}_PROMISE`
|
|
77
|
+
};
|
|
78
|
+
exports.default = IpcChannel;
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { IpcMainEvent } from 'electron';
|
|
2
|
+
import type { IResult } from '../../types.js';
|
|
3
|
+
/**
|
|
4
|
+
* Событие вызова IPC в `main` процессе.
|
|
5
|
+
*/
|
|
6
|
+
export default class IpcEventInMain {
|
|
7
|
+
private event;
|
|
8
|
+
/**
|
|
9
|
+
* Создать событие вызова IPC в `main` процессе.
|
|
10
|
+
* @param event - Оригинальное IPC событие.
|
|
11
|
+
*/
|
|
12
|
+
constructor(event: IpcMainEvent);
|
|
13
|
+
/**
|
|
14
|
+
* Отправить сообщение в канал `renderer` процесса.
|
|
15
|
+
* @param channel - IPC канал.
|
|
16
|
+
* @param result - Отправляемый результат.
|
|
17
|
+
*/
|
|
18
|
+
send(channel: string, result: IResult): void;
|
|
19
|
+
/**
|
|
20
|
+
* Вернуть результат вызова IPC.
|
|
21
|
+
* @param value - Результат.
|
|
22
|
+
*/
|
|
23
|
+
return(value: any): void;
|
|
24
|
+
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
/**
|
|
4
|
+
* Событие вызова IPC в `main` процессе.
|
|
5
|
+
*/
|
|
6
|
+
class IpcEventInMain {
|
|
7
|
+
/**
|
|
8
|
+
* Создать событие вызова IPC в `main` процессе.
|
|
9
|
+
* @param event - Оригинальное IPC событие.
|
|
10
|
+
*/
|
|
11
|
+
constructor(event) {
|
|
12
|
+
this.event = event;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Отправить сообщение в канал `renderer` процесса.
|
|
16
|
+
* @param channel - IPC канал.
|
|
17
|
+
* @param result - Отправляемый результат.
|
|
18
|
+
*/
|
|
19
|
+
send(channel, result) {
|
|
20
|
+
this.event.sender.send(channel, result);
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Вернуть результат вызова IPC.
|
|
24
|
+
* @param value - Результат.
|
|
25
|
+
*/
|
|
26
|
+
return(value) {
|
|
27
|
+
this.event.returnValue = value;
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
exports.default = IpcEventInMain;
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import type { IResult } from '../../types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Хелпер для работы с результатом IPC.
|
|
4
|
+
*/
|
|
5
|
+
export default class IpcResult {
|
|
6
|
+
/**
|
|
7
|
+
* Создать результат с обещанием.
|
|
8
|
+
* @param promiseChannel - Канал обработки обещания.
|
|
9
|
+
* @returns Результат с обещанием.
|
|
10
|
+
*/
|
|
11
|
+
static createWithPromise(promiseChannel: string): IResult;
|
|
12
|
+
/**
|
|
13
|
+
* Создать результат со значением.
|
|
14
|
+
* @param value - Значение. **Должно быть передаваемым**.
|
|
15
|
+
* @param id - Уникальный идентификатор.
|
|
16
|
+
* @returns Результат со значением.
|
|
17
|
+
*/
|
|
18
|
+
static createWithValue<T = unknown>(value: T, id?: string): IResult;
|
|
19
|
+
/**
|
|
20
|
+
* Создать результат с ошибкой.
|
|
21
|
+
* @param error - Ошибка.
|
|
22
|
+
* @param id - Уникальный идентификатор.
|
|
23
|
+
* @returns Результат с ошибкой.
|
|
24
|
+
*/
|
|
25
|
+
static createWithError(error?: Error | string, id?: string): IResult;
|
|
26
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
const transfer_js_1 = __importDefault(require("./transfer.js"));
|
|
7
|
+
/**
|
|
8
|
+
* Хелпер для работы с результатом IPC.
|
|
9
|
+
*/
|
|
10
|
+
class IpcResult {
|
|
11
|
+
/**
|
|
12
|
+
* Создать результат с обещанием.
|
|
13
|
+
* @param promiseChannel - Канал обработки обещания.
|
|
14
|
+
* @returns Результат с обещанием.
|
|
15
|
+
*/
|
|
16
|
+
static createWithPromise(promiseChannel) {
|
|
17
|
+
return { promiseChannel };
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Создать результат со значением.
|
|
21
|
+
* @param value - Значение. **Должно быть передаваемым**.
|
|
22
|
+
* @param id - Уникальный идентификатор.
|
|
23
|
+
* @returns Результат со значением.
|
|
24
|
+
*/
|
|
25
|
+
static createWithValue(value, id) {
|
|
26
|
+
return { value: transfer_js_1.default.toTransferable(value), id };
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Создать результат с ошибкой.
|
|
30
|
+
* @param error - Ошибка.
|
|
31
|
+
* @param id - Уникальный идентификатор.
|
|
32
|
+
* @returns Результат с ошибкой.
|
|
33
|
+
*/
|
|
34
|
+
static createWithError(error, id) {
|
|
35
|
+
let resultError;
|
|
36
|
+
if (error === undefined) {
|
|
37
|
+
resultError = "Unknown error";
|
|
38
|
+
}
|
|
39
|
+
else if (typeof error === 'string') {
|
|
40
|
+
resultError = error;
|
|
41
|
+
}
|
|
42
|
+
else {
|
|
43
|
+
resultError = error.stack ?? error.message;
|
|
44
|
+
}
|
|
45
|
+
return { error: resultError, id };
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
exports.default = IpcResult;
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { IHasSnapshot, ISnapshotValue } from '../../types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Хелпер для передачи значений через IPC.
|
|
4
|
+
*/
|
|
5
|
+
export default class Transfer {
|
|
6
|
+
/**
|
|
7
|
+
* Получить значение из снимка.
|
|
8
|
+
* @param value - Значение-снимок.
|
|
9
|
+
* @param Class - Класс, экземпляр которого будет создан из снимка.
|
|
10
|
+
* @returns Значение из снимка.
|
|
11
|
+
*/
|
|
12
|
+
static getFromSnapshot<TSnapshot, TClass extends {
|
|
13
|
+
new (): IHasSnapshot<TSnapshot>;
|
|
14
|
+
}>(value: ISnapshotValue<TSnapshot>, Class: TClass): InstanceType<TClass>;
|
|
15
|
+
/**
|
|
16
|
+
* Преобразовать значение в передаваемое по IPC.
|
|
17
|
+
*
|
|
18
|
+
* Если возможно, создаст снимок.
|
|
19
|
+
* @param value - Преобразуемое значение.
|
|
20
|
+
* @returns Значение, передаваемое по IPC.
|
|
21
|
+
*/
|
|
22
|
+
static toTransferable<T>(value: T): ISnapshotValue | T;
|
|
23
|
+
/**
|
|
24
|
+
* Является ли переданное по IPC значение снимком.
|
|
25
|
+
* @param value - Значение из IPC.
|
|
26
|
+
*/
|
|
27
|
+
static isSnapshotValue(value: unknown): value is ISnapshotValue;
|
|
28
|
+
/**
|
|
29
|
+
* Может ли значение вернуть снимок.
|
|
30
|
+
* @param value - Значение.
|
|
31
|
+
*/
|
|
32
|
+
static isHasSnapshot(value: unknown): value is IHasSnapshot;
|
|
33
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
/**
|
|
4
|
+
* Хелпер для передачи значений через IPC.
|
|
5
|
+
*/
|
|
6
|
+
class Transfer {
|
|
7
|
+
/**
|
|
8
|
+
* Получить значение из снимка.
|
|
9
|
+
* @param value - Значение-снимок.
|
|
10
|
+
* @param Class - Класс, экземпляр которого будет создан из снимка.
|
|
11
|
+
* @returns Значение из снимка.
|
|
12
|
+
*/
|
|
13
|
+
static getFromSnapshot(value, Class) {
|
|
14
|
+
const instance = new Class();
|
|
15
|
+
instance.updateFromSnapshot(value.__snapshot__);
|
|
16
|
+
return instance;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Преобразовать значение в передаваемое по IPC.
|
|
20
|
+
*
|
|
21
|
+
* Если возможно, создаст снимок.
|
|
22
|
+
* @param value - Преобразуемое значение.
|
|
23
|
+
* @returns Значение, передаваемое по IPC.
|
|
24
|
+
*/
|
|
25
|
+
static toTransferable(value) {
|
|
26
|
+
if (this.isHasSnapshot(value)) {
|
|
27
|
+
return {
|
|
28
|
+
__type__: 'snapshot',
|
|
29
|
+
__snapshot__: value.takeSnapshot()
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
return value;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Является ли переданное по IPC значение снимком.
|
|
36
|
+
* @param value - Значение из IPC.
|
|
37
|
+
*/
|
|
38
|
+
static isSnapshotValue(value) {
|
|
39
|
+
return (!!value
|
|
40
|
+
&& typeof value === 'object'
|
|
41
|
+
&& '__type__' in value
|
|
42
|
+
&& '__snapshot__' in value
|
|
43
|
+
&& value.__type__ === 'snapshot'
|
|
44
|
+
&& !!value.__snapshot__);
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Может ли значение вернуть снимок.
|
|
48
|
+
* @param value - Значение.
|
|
49
|
+
*/
|
|
50
|
+
static isHasSnapshot(value) {
|
|
51
|
+
return (!!value
|
|
52
|
+
&& typeof value === 'object'
|
|
53
|
+
&& 'takeSnapshot' in value
|
|
54
|
+
&& 'fromSnapshot' in value);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
exports.default = Transfer;
|
|
@@ -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,75 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
/**
|
|
4
|
+
* Обёртка над стандартным `WebContents`, позволяющая использовать события.
|
|
5
|
+
*/
|
|
6
|
+
class WebContentsEventContainer {
|
|
7
|
+
constructor() {
|
|
8
|
+
/**
|
|
9
|
+
* Контейнер событий.
|
|
10
|
+
*/
|
|
11
|
+
this.containers = {};
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Добавить многоразового отправителя для события.
|
|
15
|
+
* @param event - Имя события.
|
|
16
|
+
* @param sender - Отправитель.
|
|
17
|
+
*/
|
|
18
|
+
addOn(event, sender) {
|
|
19
|
+
this.addEvent(event).on.push(sender);
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Добавить одноразового отправителя для события.
|
|
23
|
+
* @param event - Имя события.
|
|
24
|
+
* @param sender - Отправитель.
|
|
25
|
+
*/
|
|
26
|
+
addOnce(event, sender) {
|
|
27
|
+
this.addEvent(event).once.push(sender);
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Получить многоразовых отправителей для события.
|
|
31
|
+
* @param event - Имя события.
|
|
32
|
+
* @returns многоразовые отправители для события.
|
|
33
|
+
*/
|
|
34
|
+
getOn(event) {
|
|
35
|
+
return this.addEvent(event).on;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Получить одноразовых отправителей для события.
|
|
39
|
+
* @param event - Имя события.
|
|
40
|
+
* @returns Одноразовые отправители для события.
|
|
41
|
+
*/
|
|
42
|
+
getOnce(event) {
|
|
43
|
+
return this.addEvent(event).once;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Получить всех отправителей для события.
|
|
47
|
+
* @param event - Имя события.
|
|
48
|
+
* @returns Отправители для события.
|
|
49
|
+
*/
|
|
50
|
+
getAll(event) {
|
|
51
|
+
const container = this.addEvent(event);
|
|
52
|
+
return [...container.on, ...container.once];
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Удалить одноразовых отправителей для события.
|
|
56
|
+
* @param event - Имя события.
|
|
57
|
+
*/
|
|
58
|
+
clearOnce(event) {
|
|
59
|
+
this.addEvent(event).once = [];
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Добавить контейнер события.
|
|
63
|
+
* @param name - Имя события.
|
|
64
|
+
* @returns Добавленный контейнер.
|
|
65
|
+
*/
|
|
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
|
+
};
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
exports.default = WebContentsEventContainer;
|
|
@@ -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;
|