emr-bridge 1.7.1 → 2.0.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.
- 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/enums.d.ts +5 -14
- package/cjs/enums.js +12 -23
- package/cjs/errors.d.ts +42 -10
- package/cjs/errors.js +77 -23
- package/cjs/index.d.ts +4 -4
- package/cjs/index.js +11 -13
- package/cjs/main.d.ts +2 -4
- package/cjs/main.js +4 -13
- package/cjs/preload.d.ts +2 -2
- package/cjs/preload.js +3 -3
- package/cjs/renderer.d.ts +1 -1
- package/cjs/scripts/base-bridge.d.ts +95 -0
- package/cjs/scripts/base-bridge.js +128 -0
- package/cjs/scripts/bridge.d.ts +3 -3
- package/cjs/scripts/bridge.js +48 -36
- package/cjs/scripts/helpers/env.d.ts +19 -0
- package/cjs/scripts/helpers/env.js +28 -0
- package/cjs/scripts/helpers/error-thrower.d.ts +3 -0
- package/cjs/scripts/helpers/error-thrower.js +8 -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/main-event.d.ts +8 -0
- package/cjs/scripts/helpers/main-event.js +15 -0
- package/cjs/scripts/helpers/transfer.d.ts +33 -0
- package/cjs/scripts/helpers/transfer.js +57 -0
- package/cjs/scripts/helpers/web-contents-container.d.ts +12 -0
- package/cjs/scripts/helpers/web-contents-container.js +34 -0
- package/cjs/scripts/helpers/web-contents-events-container.d.ts +56 -0
- package/cjs/scripts/helpers/web-contents-events-container.js +81 -0
- package/cjs/scripts/main/publish.d.ts +36 -0
- package/cjs/scripts/main/publish.js +186 -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/preload-bridge.d.ts +20 -0
- package/cjs/scripts/preload-bridge.js +76 -0
- package/cjs/scripts/preload-provider.js +34 -50
- package/cjs/scripts/provider.d.ts +17 -15
- package/cjs/scripts/provider.js +69 -90
- package/cjs/scripts/publish.d.ts +19 -18
- package/cjs/scripts/publish.js +96 -174
- 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/scripts/renderer-tunnels.d.ts +19 -21
- package/cjs/scripts/renderer-tunnels.js +52 -57
- 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/enums.d.ts +5 -14
- package/esm/enums.js +11 -22
- package/esm/errors.d.ts +42 -10
- package/esm/errors.js +69 -16
- package/esm/helpers.d.ts +41 -0
- package/esm/helpers.js +96 -0
- package/esm/index.d.ts +4 -4
- package/esm/index.js +3 -3
- package/esm/main.d.ts +2 -4
- package/esm/main.js +1 -3
- package/esm/preload.d.ts +2 -2
- package/esm/preload.js +1 -1
- package/esm/renderer.d.ts +1 -1
- package/esm/scripts/base-bridge.d.ts +95 -0
- package/esm/scripts/base-bridge.js +125 -0
- package/esm/scripts/bridge.d.ts +3 -3
- package/esm/scripts/bridge.js +49 -37
- package/esm/scripts/helpers/electron-importer.d.ts +4 -0
- package/esm/scripts/helpers/electron-importer.js +16 -0
- package/esm/scripts/helpers/env.d.ts +19 -0
- package/esm/scripts/helpers/env.js +25 -0
- package/esm/scripts/helpers/error-thrower.d.ts +3 -0
- package/esm/scripts/helpers/error-thrower.js +5 -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/main-event.d.ts +8 -0
- package/esm/scripts/helpers/main-event.js +12 -0
- package/esm/scripts/helpers/transfer.d.ts +33 -0
- package/esm/scripts/helpers/transfer.js +54 -0
- package/esm/scripts/helpers/web-contents-container.d.ts +12 -0
- package/esm/scripts/helpers/web-contents-container.js +31 -0
- package/esm/scripts/helpers/web-contents-events-container.d.ts +56 -0
- package/esm/scripts/helpers/web-contents-events-container.js +78 -0
- package/esm/scripts/main/publish.d.ts +36 -0
- package/esm/scripts/main/publish.js +179 -0
- package/esm/scripts/main.d.ts +3 -3
- package/esm/scripts/main.js +41 -39
- 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/preload-bridge.d.ts +20 -0
- package/esm/scripts/preload-bridge.js +68 -0
- package/esm/scripts/preload-provider.js +34 -50
- package/esm/scripts/provider.d.ts +17 -15
- package/esm/scripts/provider.js +70 -91
- package/esm/scripts/publish.d.ts +19 -18
- package/esm/scripts/publish.js +89 -162
- 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/scripts/renderer-tunnels.d.ts +19 -21
- package/esm/scripts/renderer-tunnels.js +53 -55
- package/esm/types.d.ts +189 -64
- package/package.json +23 -41
- package/cjs/exp.d.ts +0 -4
- package/cjs/exp.js +0 -19
- 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/esm/exp.d.ts +0 -4
- package/esm/exp.js +0 -3
- 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
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const errors_js_1 = require("../errors.js");
|
|
4
|
+
const index_js_1 = require("./helpers/index.js");
|
|
5
|
+
/**
|
|
6
|
+
* Базовый класс моста до main.
|
|
7
|
+
*/
|
|
8
|
+
class BaseBridge {
|
|
9
|
+
constructor() {
|
|
10
|
+
/**
|
|
11
|
+
* Объект, который будет использоваться пользователем.
|
|
12
|
+
*/
|
|
13
|
+
this.target = {
|
|
14
|
+
as: () => this.as(),
|
|
15
|
+
emit: (...args) => this.emit(...args),
|
|
16
|
+
on: (...args) => this.on(...args),
|
|
17
|
+
once: (...args) => this.once(...args),
|
|
18
|
+
call: (...args) => this.call(...args),
|
|
19
|
+
returns: (...args) => this.returns(...args)
|
|
20
|
+
};
|
|
21
|
+
}
|
|
22
|
+
as() {
|
|
23
|
+
return this.target;
|
|
24
|
+
}
|
|
25
|
+
emit(name, value) {
|
|
26
|
+
this.emitEvent(name, index_js_1.Transfer.toTransferable(value));
|
|
27
|
+
}
|
|
28
|
+
on(name, listener) {
|
|
29
|
+
return this.handleEvent(name, 'on', ({ value, error }) => {
|
|
30
|
+
this.handlePossibleError(`event: ${name}`, error);
|
|
31
|
+
listener(value);
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
once(name, listener) {
|
|
35
|
+
return this.handleEvent(name, 'once', ({ value, error }) => {
|
|
36
|
+
this.handlePossibleError(`event: ${name}`, error);
|
|
37
|
+
listener(value);
|
|
38
|
+
});
|
|
39
|
+
}
|
|
40
|
+
call(func, Class, args) {
|
|
41
|
+
const value = func(...args);
|
|
42
|
+
if (index_js_1.Transfer.isSnapshotValue(value)) {
|
|
43
|
+
return index_js_1.Transfer.getFromSnapshot(value, Class);
|
|
44
|
+
}
|
|
45
|
+
return value;
|
|
46
|
+
}
|
|
47
|
+
returns(func, Class) {
|
|
48
|
+
return ((...args) => this.call(func, Class, args));
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Инициализация моста.
|
|
52
|
+
*/
|
|
53
|
+
init() {
|
|
54
|
+
this.initFunctions();
|
|
55
|
+
this.initVariables();
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Обработать возможную ошибку.
|
|
59
|
+
*
|
|
60
|
+
* Бросает ошибку если она была передана.
|
|
61
|
+
* @param channel - IPC канал.
|
|
62
|
+
* @param error - Возможная ошибка (текст).
|
|
63
|
+
*/
|
|
64
|
+
handlePossibleError(channel, error) {
|
|
65
|
+
if (!error) {
|
|
66
|
+
return;
|
|
67
|
+
}
|
|
68
|
+
throw new Error(`Error on ${channel}.\n${error}`.replace('Error: ', ''));
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Инициализировать доступ к публичным функциям.
|
|
72
|
+
*/
|
|
73
|
+
initFunctions() {
|
|
74
|
+
for (const name of this.entitiesInfo.functions) {
|
|
75
|
+
this.define(name, {
|
|
76
|
+
value: (...args) => {
|
|
77
|
+
const id = index_js_1.Id.new();
|
|
78
|
+
const preparedArgs = args.map(arg => index_js_1.Transfer.toTransferable(arg));
|
|
79
|
+
const { error, promiseChannel, value } = this.callFunction(name, id, preparedArgs);
|
|
80
|
+
this.handlePossibleError(name, error);
|
|
81
|
+
return promiseChannel
|
|
82
|
+
? this.waitPromise(promiseChannel, id)
|
|
83
|
+
: value;
|
|
84
|
+
}
|
|
85
|
+
});
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
/**
|
|
89
|
+
* Инициализировать доступ к публичным переменным.
|
|
90
|
+
*/
|
|
91
|
+
initVariables() {
|
|
92
|
+
for (const name of this.entitiesInfo.variables) {
|
|
93
|
+
this.define(name, {
|
|
94
|
+
get: () => {
|
|
95
|
+
const { error, value } = this.getVariable(name);
|
|
96
|
+
this.handlePossibleError(name, error);
|
|
97
|
+
return value;
|
|
98
|
+
},
|
|
99
|
+
set: (value) => {
|
|
100
|
+
const { error } = this.setVariable(name, value);
|
|
101
|
+
this.handlePossibleError(name, error);
|
|
102
|
+
}
|
|
103
|
+
});
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
/**
|
|
107
|
+
* Добавить сущность в `target`.
|
|
108
|
+
* @param name - Имя.
|
|
109
|
+
* @param descriptor - Дескриптор значения.
|
|
110
|
+
*/
|
|
111
|
+
define(name, descriptor) {
|
|
112
|
+
const hasValue = Boolean(descriptor?.value);
|
|
113
|
+
const defaultDescriptor = {
|
|
114
|
+
get: () => descriptor.value,
|
|
115
|
+
set: index_js_1.Errors.getThrower(errors_js_1.TrySetReadonlyError, name),
|
|
116
|
+
enumerable: true
|
|
117
|
+
};
|
|
118
|
+
const noValueDescriptor = {
|
|
119
|
+
get: descriptor?.get || index_js_1.Errors.getThrower(errors_js_1.NoGetAccessError, name),
|
|
120
|
+
set: descriptor?.set || index_js_1.Errors.getThrower(errors_js_1.TrySetReadonlyError, name),
|
|
121
|
+
enumerable: true
|
|
122
|
+
};
|
|
123
|
+
Object.defineProperty(this.target, name, hasValue
|
|
124
|
+
? defaultDescriptor
|
|
125
|
+
: noValueDescriptor);
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
exports.default = BaseBridge;
|
package/cjs/scripts/bridge.d.ts
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
import type {
|
|
1
|
+
import type { IBridge } from '../types.js';
|
|
2
2
|
/**
|
|
3
3
|
* Bridge between `renderer` and `main` processes.
|
|
4
4
|
*
|
|
5
5
|
* _only for renderer process_
|
|
6
6
|
*/
|
|
7
|
-
declare
|
|
8
|
-
export default
|
|
7
|
+
declare const _default: IBridge;
|
|
8
|
+
export default _default;
|
package/cjs/scripts/bridge.js
CHANGED
|
@@ -3,55 +3,67 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
|
3
3
|
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
4
|
};
|
|
5
5
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
-
const enums_js_1 = require("../enums.js");
|
|
7
6
|
const errors_js_1 = require("../errors.js");
|
|
7
|
+
const index_js_1 = require("./helpers/index.js");
|
|
8
8
|
const provider_js_1 = __importDefault(require("./provider.js"));
|
|
9
|
-
/**
|
|
10
|
-
* Bridge between `renderer` and `main` processes.
|
|
11
|
-
*
|
|
12
|
-
* _only for renderer process_
|
|
13
|
-
*/
|
|
14
|
-
let Bridge = new Proxy({ as: () => throwError() }, {
|
|
15
|
-
get: () => throwError(),
|
|
16
|
-
set: () => throwError(),
|
|
17
|
-
apply: () => throwError()
|
|
18
|
-
});
|
|
19
9
|
class ProviderIntoRenderer extends provider_js_1.default {
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
10
|
+
globalProvider;
|
|
11
|
+
entitiesInfo;
|
|
12
|
+
constructor() {
|
|
13
|
+
super();
|
|
14
|
+
if (!window.__provider__) {
|
|
15
|
+
throw new errors_js_1.NotProvidedFromMain();
|
|
16
|
+
}
|
|
17
|
+
this.globalProvider = window.__provider__;
|
|
18
|
+
this.entitiesInfo = this.globalProvider.getEntitiesInfo();
|
|
19
|
+
this.init();
|
|
20
|
+
}
|
|
21
|
+
callFunction(name, id, args) {
|
|
22
|
+
return this.globalProvider.entities.functions[name](id, args);
|
|
26
23
|
}
|
|
27
24
|
getVariable(name) {
|
|
28
|
-
return this
|
|
25
|
+
return this.globalProvider.entities.variables[name].get();
|
|
29
26
|
}
|
|
30
27
|
setVariable(name, value) {
|
|
31
|
-
return this
|
|
28
|
+
return this.globalProvider.entities.variables[name].set(value);
|
|
32
29
|
}
|
|
33
|
-
waitPromise(channel,
|
|
30
|
+
waitPromise(channel, id) {
|
|
34
31
|
return new Promise((resolve, reject) => {
|
|
35
|
-
this
|
|
32
|
+
this.globalProvider.waitPromise(channel, resolve, reject, id);
|
|
36
33
|
});
|
|
37
34
|
}
|
|
38
|
-
|
|
39
|
-
return
|
|
35
|
+
handleEvent(name, type, listener) {
|
|
36
|
+
return type === 'on'
|
|
37
|
+
? this.globalProvider.entities.events.on(name, listener)
|
|
38
|
+
: this.globalProvider.entities.events.once(name, listener);
|
|
40
39
|
}
|
|
41
|
-
|
|
42
|
-
this
|
|
40
|
+
emitEvent(name, value) {
|
|
41
|
+
this.globalProvider.entities.events.emit(name, value);
|
|
43
42
|
}
|
|
44
43
|
}
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
44
|
+
function getErrorThrower() {
|
|
45
|
+
if (!index_js_1.Env.global.hasWindow) {
|
|
46
|
+
return index_js_1.ErrorThrower.throws(errors_js_1.TryUseBridgeInPreload);
|
|
47
|
+
}
|
|
48
|
+
if (!index_js_1.Env.global.hasProvider) {
|
|
49
|
+
return index_js_1.ErrorThrower.throws(errors_js_1.GlobalProviderNotFoundError);
|
|
50
|
+
}
|
|
51
|
+
return null;
|
|
52
52
|
}
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
53
|
+
function getBridge() {
|
|
54
|
+
const throwError = getErrorThrower();
|
|
55
|
+
if (throwError) {
|
|
56
|
+
return new Proxy({}, {
|
|
57
|
+
get: throwError,
|
|
58
|
+
set: throwError,
|
|
59
|
+
apply: throwError
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
return new ProviderIntoRenderer();
|
|
56
63
|
}
|
|
57
|
-
|
|
64
|
+
/**
|
|
65
|
+
* Bridge between `renderer` and `main` processes.
|
|
66
|
+
*
|
|
67
|
+
* _only for renderer process_
|
|
68
|
+
*/
|
|
69
|
+
exports.default = getBridge();
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Хелпер для работы с исполняемым окружением.
|
|
3
|
+
*/
|
|
4
|
+
export default class Env {
|
|
5
|
+
/**
|
|
6
|
+
* Есть ли объект `window`.
|
|
7
|
+
*/
|
|
8
|
+
static get hasWindow(): boolean;
|
|
9
|
+
/**
|
|
10
|
+
* Есть ли провайдер необходимых методов из `preload` в `renderer`. (`window.__provider__`)
|
|
11
|
+
*/
|
|
12
|
+
static get hasProvider(): boolean;
|
|
13
|
+
/**
|
|
14
|
+
* Является ли окружение `preload` процессом.
|
|
15
|
+
*
|
|
16
|
+
* Работает корректно только если запущено в `preload` или `renderer`.
|
|
17
|
+
*/
|
|
18
|
+
static get isPreload(): boolean;
|
|
19
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
/**
|
|
4
|
+
* Хелпер для работы с исполняемым окружением.
|
|
5
|
+
*/
|
|
6
|
+
class Env {
|
|
7
|
+
/**
|
|
8
|
+
* Есть ли объект `window`.
|
|
9
|
+
*/
|
|
10
|
+
static get hasWindow() {
|
|
11
|
+
return typeof window !== 'undefined';
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Есть ли провайдер необходимых методов из `preload` в `renderer`. (`window.__provider__`)
|
|
15
|
+
*/
|
|
16
|
+
static get hasProvider() {
|
|
17
|
+
return Boolean(window.__provider__);
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Является ли окружение `preload` процессом.
|
|
21
|
+
*
|
|
22
|
+
* Работает корректно только если запущено в `preload` или `renderer`.
|
|
23
|
+
*/
|
|
24
|
+
static get isPreload() {
|
|
25
|
+
return typeof global !== 'undefined';
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
exports.default = Env;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Хелпер для работы с ошибками.
|
|
3
|
+
*/
|
|
4
|
+
export default class Errors {
|
|
5
|
+
/**
|
|
6
|
+
* Получить функцию выброса ошибки.
|
|
7
|
+
* @param errorClass - Класс ошибки.
|
|
8
|
+
* @param args - Аргументы создания класса.
|
|
9
|
+
* @returns Функция выброса ошибки.
|
|
10
|
+
*/
|
|
11
|
+
static getThrower<TClass extends new (...args: TArgs) => InstanceType<TClass>, TArgs extends any[]>(errorClass: TClass, ...args: TArgs): () => never;
|
|
12
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
/**
|
|
4
|
+
* Хелпер для работы с ошибками.
|
|
5
|
+
*/
|
|
6
|
+
class Errors {
|
|
7
|
+
/**
|
|
8
|
+
* Получить функцию выброса ошибки.
|
|
9
|
+
* @param errorClass - Класс ошибки.
|
|
10
|
+
* @param args - Аргументы создания класса.
|
|
11
|
+
* @returns Функция выброса ошибки.
|
|
12
|
+
*/
|
|
13
|
+
static getThrower(errorClass, ...args) {
|
|
14
|
+
return () => { throw new errorClass(...args); };
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
exports.default = Errors;
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
/**
|
|
4
|
+
* Хелпер для работы с идентификаторами.
|
|
5
|
+
*/
|
|
6
|
+
class Id {
|
|
7
|
+
/**
|
|
8
|
+
* Создать новый идентификатор.
|
|
9
|
+
*/
|
|
10
|
+
static new() {
|
|
11
|
+
return Math.random().toString();
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
exports.default = Id;
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
export { default as Env } from './env.js';
|
|
2
|
+
export { default as Errors } from './errors.js';
|
|
3
|
+
export { default as Id } from './id.js';
|
|
4
|
+
export { default as IpcChannel } from './ipc-channel.js';
|
|
5
|
+
export { default as IpcEventInMain } from './ipc-event-in-main.js';
|
|
6
|
+
export { default as IpcResult } from './ipc-result.js';
|
|
7
|
+
export { default as Transfer } from './transfer.js';
|
|
8
|
+
export { default as WebContentsEventsContainer } from './web-contents-events-container.js';
|
|
@@ -0,0 +1,22 @@
|
|
|
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
|
+
exports.WebContentsEventsContainer = exports.Transfer = exports.IpcResult = exports.IpcEventInMain = exports.IpcChannel = exports.Id = exports.Errors = exports.Env = void 0;
|
|
7
|
+
var env_js_1 = require("./env.js");
|
|
8
|
+
Object.defineProperty(exports, "Env", { enumerable: true, get: function () { return __importDefault(env_js_1).default; } });
|
|
9
|
+
var errors_js_1 = require("./errors.js");
|
|
10
|
+
Object.defineProperty(exports, "Errors", { enumerable: true, get: function () { return __importDefault(errors_js_1).default; } });
|
|
11
|
+
var id_js_1 = require("./id.js");
|
|
12
|
+
Object.defineProperty(exports, "Id", { enumerable: true, get: function () { return __importDefault(id_js_1).default; } });
|
|
13
|
+
var ipc_channel_js_1 = require("./ipc-channel.js");
|
|
14
|
+
Object.defineProperty(exports, "IpcChannel", { enumerable: true, get: function () { return __importDefault(ipc_channel_js_1).default; } });
|
|
15
|
+
var ipc_event_in_main_js_1 = require("./ipc-event-in-main.js");
|
|
16
|
+
Object.defineProperty(exports, "IpcEventInMain", { enumerable: true, get: function () { return __importDefault(ipc_event_in_main_js_1).default; } });
|
|
17
|
+
var ipc_result_js_1 = require("./ipc-result.js");
|
|
18
|
+
Object.defineProperty(exports, "IpcResult", { enumerable: true, get: function () { return __importDefault(ipc_result_js_1).default; } });
|
|
19
|
+
var transfer_js_1 = require("./transfer.js");
|
|
20
|
+
Object.defineProperty(exports, "Transfer", { enumerable: true, get: function () { return __importDefault(transfer_js_1).default; } });
|
|
21
|
+
var web_contents_events_container_js_1 = require("./web-contents-events-container.js");
|
|
22
|
+
Object.defineProperty(exports, "WebContentsEventsContainer", { enumerable: true, get: function () { return __importDefault(web_contents_events_container_js_1).default; } });
|
|
@@ -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
|
+
}
|