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,27 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/*
|
|
3
|
+
Экспорт для `main` процесса.
|
|
4
|
+
*/
|
|
5
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
6
|
+
if (k2 === undefined) k2 = k;
|
|
7
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
8
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
9
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
10
|
+
}
|
|
11
|
+
Object.defineProperty(o, k2, desc);
|
|
12
|
+
}) : (function(o, m, k, k2) {
|
|
13
|
+
if (k2 === undefined) k2 = k;
|
|
14
|
+
o[k2] = m[k];
|
|
15
|
+
}));
|
|
16
|
+
var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
17
|
+
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
18
|
+
};
|
|
19
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
20
|
+
exports.publishVariable = exports.publishFunction = exports.once = exports.on = exports.emitEvent = void 0;
|
|
21
|
+
var publish_js_1 = require("../scripts/main/publish.js");
|
|
22
|
+
Object.defineProperty(exports, "emitEvent", { enumerable: true, get: function () { return publish_js_1.emitEvent; } });
|
|
23
|
+
Object.defineProperty(exports, "on", { enumerable: true, get: function () { return publish_js_1.on; } });
|
|
24
|
+
Object.defineProperty(exports, "once", { enumerable: true, get: function () { return publish_js_1.once; } });
|
|
25
|
+
Object.defineProperty(exports, "publishFunction", { enumerable: true, get: function () { return publish_js_1.publishFunction; } });
|
|
26
|
+
Object.defineProperty(exports, "publishVariable", { enumerable: true, get: function () { return publish_js_1.publishVariable; } });
|
|
27
|
+
__exportStar(require("./index.js"), exports);
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/*
|
|
3
|
+
Экспорт для `preload` процесса.
|
|
4
|
+
Нельзя объединить с `renderer` из-за ошибки импорта electron.
|
|
5
|
+
*/
|
|
6
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
7
|
+
if (k2 === undefined) k2 = k;
|
|
8
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
9
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
10
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
11
|
+
}
|
|
12
|
+
Object.defineProperty(o, k2, desc);
|
|
13
|
+
}) : (function(o, m, k, k2) {
|
|
14
|
+
if (k2 === undefined) k2 = k;
|
|
15
|
+
o[k2] = m[k];
|
|
16
|
+
}));
|
|
17
|
+
var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
18
|
+
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
19
|
+
};
|
|
20
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
21
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
22
|
+
};
|
|
23
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
24
|
+
exports.provideFromMain = exports.Bridge = void 0;
|
|
25
|
+
var bridge_js_1 = require("../scripts/preload/bridge.js");
|
|
26
|
+
Object.defineProperty(exports, "Bridge", { enumerable: true, get: function () { return __importDefault(bridge_js_1).default; } });
|
|
27
|
+
var provider_js_1 = require("../scripts/preload/provider.js");
|
|
28
|
+
Object.defineProperty(exports, "provideFromMain", { enumerable: true, get: function () { return __importDefault(provider_js_1).default; } });
|
|
29
|
+
__exportStar(require("./index.js"), exports);
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/*
|
|
3
|
+
Экспорт для `renderer` процесса.
|
|
4
|
+
Нельзя объединить с `preload` из-за ошибки импорта electron.
|
|
5
|
+
*/
|
|
6
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
7
|
+
if (k2 === undefined) k2 = k;
|
|
8
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
9
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
10
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
11
|
+
}
|
|
12
|
+
Object.defineProperty(o, k2, desc);
|
|
13
|
+
}) : (function(o, m, k, k2) {
|
|
14
|
+
if (k2 === undefined) k2 = k;
|
|
15
|
+
o[k2] = m[k];
|
|
16
|
+
}));
|
|
17
|
+
var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
18
|
+
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
19
|
+
};
|
|
20
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
21
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
22
|
+
};
|
|
23
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
24
|
+
exports.Bridge = void 0;
|
|
25
|
+
var bridge_js_1 = require("../scripts/renderer/bridge.js");
|
|
26
|
+
Object.defineProperty(exports, "Bridge", { enumerable: true, get: function () { return __importDefault(bridge_js_1).default; } });
|
|
27
|
+
__exportStar(require("./index.js"), exports);
|
package/cjs/errors.d.ts
CHANGED
|
@@ -1,28 +1,60 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* Нет доступа к получению переменной.
|
|
3
|
+
*/
|
|
5
4
|
export declare class NoGetAccessError extends Error {
|
|
6
5
|
constructor(name: string);
|
|
7
6
|
}
|
|
8
|
-
|
|
9
|
-
|
|
7
|
+
/**
|
|
8
|
+
* Нет публичных сущностей.
|
|
9
|
+
*/
|
|
10
|
+
export declare class NotProvidedFromMainError extends Error {
|
|
11
|
+
constructor();
|
|
10
12
|
}
|
|
11
|
-
|
|
13
|
+
/**
|
|
14
|
+
* Публикация доступна только в main процессе.
|
|
15
|
+
*/
|
|
16
|
+
export declare class PublishMethodsUnavailableError extends Error {
|
|
12
17
|
constructor();
|
|
13
18
|
}
|
|
19
|
+
/**
|
|
20
|
+
* Нет провайдера.
|
|
21
|
+
*/
|
|
14
22
|
export declare class GlobalProviderNotFoundError extends Error {
|
|
15
23
|
constructor();
|
|
16
24
|
}
|
|
25
|
+
/**
|
|
26
|
+
* Попытка установить свойство, доступное только для чтения.
|
|
27
|
+
*/
|
|
17
28
|
export declare class TrySetReadonlyError extends Error {
|
|
18
29
|
constructor(name: string);
|
|
19
30
|
}
|
|
20
|
-
|
|
31
|
+
/**
|
|
32
|
+
* Использование неверного `Bridge` в preload процессе.
|
|
33
|
+
*/
|
|
34
|
+
export declare class WrongBridgeInPreloadError extends Error {
|
|
35
|
+
constructor();
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Использование неверного `Bridge` в renderer процессе.
|
|
39
|
+
*/
|
|
40
|
+
export declare class WrongBridgeInRendererError extends Error {
|
|
41
|
+
constructor();
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Попытка использовать `Bridge` в main процессе.
|
|
45
|
+
*/
|
|
46
|
+
export declare class TryUseBridgeInMainError extends Error {
|
|
21
47
|
constructor();
|
|
22
48
|
}
|
|
23
|
-
|
|
49
|
+
/**
|
|
50
|
+
* Попытка добавить провайдер в main процессе.
|
|
51
|
+
*/
|
|
52
|
+
export declare class TryProvideInMainError extends Error {
|
|
24
53
|
constructor();
|
|
25
54
|
}
|
|
26
|
-
|
|
55
|
+
/**
|
|
56
|
+
* Попытка добавить провайдер в renderer процессе.
|
|
57
|
+
*/
|
|
58
|
+
export declare class TryProvideInRendererError extends Error {
|
|
27
59
|
constructor();
|
|
28
60
|
}
|
package/cjs/errors.js
CHANGED
|
@@ -1,39 +1,93 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
exports.NoSetAccessError = NoSetAccessError;
|
|
3
|
+
exports.TryProvideInRendererError = exports.TryProvideInMainError = exports.TryUseBridgeInMainError = exports.WrongBridgeInRendererError = exports.WrongBridgeInPreloadError = exports.TrySetReadonlyError = exports.GlobalProviderNotFoundError = exports.PublishMethodsUnavailableError = exports.NotProvidedFromMainError = exports.NoGetAccessError = void 0;
|
|
4
|
+
/**
|
|
5
|
+
* Нет доступа к получению переменной.
|
|
6
|
+
*/
|
|
8
7
|
class NoGetAccessError extends Error {
|
|
9
|
-
constructor(name) {
|
|
8
|
+
constructor(name) {
|
|
9
|
+
super(`Нет доступа к получению '${name}'.`);
|
|
10
|
+
}
|
|
10
11
|
}
|
|
11
12
|
exports.NoGetAccessError = NoGetAccessError;
|
|
12
|
-
|
|
13
|
-
|
|
13
|
+
/**
|
|
14
|
+
* Нет публичных сущностей.
|
|
15
|
+
*/
|
|
16
|
+
class NotProvidedFromMainError extends Error {
|
|
17
|
+
constructor() {
|
|
18
|
+
super('Публичные сущности не найдены. Добавьте их в main процессе.');
|
|
19
|
+
}
|
|
14
20
|
}
|
|
15
|
-
exports.
|
|
16
|
-
|
|
17
|
-
|
|
21
|
+
exports.NotProvidedFromMainError = NotProvidedFromMainError;
|
|
22
|
+
/**
|
|
23
|
+
* Публикация доступна только в main процессе.
|
|
24
|
+
*/
|
|
25
|
+
class PublishMethodsUnavailableError extends Error {
|
|
26
|
+
constructor() {
|
|
27
|
+
super('Публикация доступна только в main процессе.');
|
|
28
|
+
}
|
|
18
29
|
}
|
|
19
|
-
exports.
|
|
30
|
+
exports.PublishMethodsUnavailableError = PublishMethodsUnavailableError;
|
|
31
|
+
/**
|
|
32
|
+
* Нет провайдера.
|
|
33
|
+
*/
|
|
20
34
|
class GlobalProviderNotFoundError extends Error {
|
|
21
|
-
constructor() {
|
|
35
|
+
constructor() {
|
|
36
|
+
super('Провайдер не найден. Вызовите "provideFromMain" в preload процессе.');
|
|
37
|
+
}
|
|
22
38
|
}
|
|
23
39
|
exports.GlobalProviderNotFoundError = GlobalProviderNotFoundError;
|
|
40
|
+
/**
|
|
41
|
+
* Попытка установить свойство, доступное только для чтения.
|
|
42
|
+
*/
|
|
24
43
|
class TrySetReadonlyError extends Error {
|
|
25
|
-
constructor(name) {
|
|
44
|
+
constructor(name) {
|
|
45
|
+
super(`'${name}' доступно только для чтения.`);
|
|
46
|
+
}
|
|
26
47
|
}
|
|
27
48
|
exports.TrySetReadonlyError = TrySetReadonlyError;
|
|
28
|
-
|
|
29
|
-
|
|
49
|
+
/**
|
|
50
|
+
* Использование неверного `Bridge` в preload процессе.
|
|
51
|
+
*/
|
|
52
|
+
class WrongBridgeInPreloadError extends Error {
|
|
53
|
+
constructor() {
|
|
54
|
+
super('Попытка использовать в preload процессе "Bridge" для renderer процесса. Проверьте импорт.');
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
exports.WrongBridgeInPreloadError = WrongBridgeInPreloadError;
|
|
58
|
+
/**
|
|
59
|
+
* Использование неверного `Bridge` в renderer процессе.
|
|
60
|
+
*/
|
|
61
|
+
class WrongBridgeInRendererError extends Error {
|
|
62
|
+
constructor() {
|
|
63
|
+
super('Попытка использовать в renderer процессе "Bridge" для preload процесса. Проверьте импорт.');
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
exports.WrongBridgeInRendererError = WrongBridgeInRendererError;
|
|
67
|
+
/**
|
|
68
|
+
* Попытка использовать `Bridge` в main процессе.
|
|
69
|
+
*/
|
|
70
|
+
class TryUseBridgeInMainError extends Error {
|
|
71
|
+
constructor() {
|
|
72
|
+
super('"Bridge" недоступен в main процессе.');
|
|
73
|
+
}
|
|
30
74
|
}
|
|
31
|
-
exports.
|
|
32
|
-
|
|
33
|
-
|
|
75
|
+
exports.TryUseBridgeInMainError = TryUseBridgeInMainError;
|
|
76
|
+
/**
|
|
77
|
+
* Попытка добавить провайдер в main процессе.
|
|
78
|
+
*/
|
|
79
|
+
class TryProvideInMainError extends Error {
|
|
80
|
+
constructor() {
|
|
81
|
+
super('"provideFromMain" недоступен в main процессе.');
|
|
82
|
+
}
|
|
34
83
|
}
|
|
35
|
-
exports.
|
|
36
|
-
|
|
37
|
-
|
|
84
|
+
exports.TryProvideInMainError = TryProvideInMainError;
|
|
85
|
+
/**
|
|
86
|
+
* Попытка добавить провайдер в renderer процессе.
|
|
87
|
+
*/
|
|
88
|
+
class TryProvideInRendererError extends Error {
|
|
89
|
+
constructor() {
|
|
90
|
+
super('"provideFromMain" недоступен в renderer процессе.');
|
|
91
|
+
}
|
|
38
92
|
}
|
|
39
|
-
exports.
|
|
93
|
+
exports.TryProvideInRendererError = TryProvideInRendererError;
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import type { EventListener, EventUnsubscribe, IBridge, IEntitiesInfo, IHasSnapshot, IResult } from '../types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Базовый класс моста до main.
|
|
4
|
+
*/
|
|
5
|
+
export default abstract class BaseBridge implements IBridge {
|
|
6
|
+
/**
|
|
7
|
+
* Информация о сущностях.
|
|
8
|
+
*/
|
|
9
|
+
protected abstract entitiesInfo: IEntitiesInfo;
|
|
10
|
+
/**
|
|
11
|
+
* Объект, который будет использоваться пользователем.
|
|
12
|
+
*/
|
|
13
|
+
protected readonly target: {
|
|
14
|
+
as: () => any;
|
|
15
|
+
emit: (name: string, value: any) => void;
|
|
16
|
+
on: (name: string, listener: (() => void) | ((result: any) => void)) => EventUnsubscribe;
|
|
17
|
+
once: (name: string, listener: (() => void) | ((result: any) => void)) => EventUnsubscribe;
|
|
18
|
+
call: (func: any, Class: any, args: unknown[]) => any;
|
|
19
|
+
returns: (func: any, Class: any) => any;
|
|
20
|
+
};
|
|
21
|
+
as<TTarget>(): IBridge & TTarget;
|
|
22
|
+
emit(name: string, value: any): void;
|
|
23
|
+
on<TValue = any>(name: string, listener: EventListener<TValue>): EventUnsubscribe;
|
|
24
|
+
once<TValue = any>(name: string, listener: EventListener<TValue>): EventUnsubscribe;
|
|
25
|
+
call<TFunc extends (...args: any[]) => InstanceType<TClass>, TClass extends {
|
|
26
|
+
new (): IHasSnapshot;
|
|
27
|
+
}>(func: TFunc, Class: TClass, args: Parameters<TFunc>): InstanceType<TClass>;
|
|
28
|
+
returns<TFunc extends (...args: any[]) => InstanceType<TClass>, TClass extends {
|
|
29
|
+
new (): IHasSnapshot;
|
|
30
|
+
}>(func: TFunc, Class: TClass): TFunc;
|
|
31
|
+
/**
|
|
32
|
+
* Получить значение публичной переменной.
|
|
33
|
+
* @param name - Имя переменной.
|
|
34
|
+
*/
|
|
35
|
+
protected abstract getVariable<TValue = unknown>(name: string): IResult<TValue>;
|
|
36
|
+
/**
|
|
37
|
+
* Установить значение публичной переменной.
|
|
38
|
+
* @param name - Имя переменной.
|
|
39
|
+
* @param value - Устанавливаемое значение.
|
|
40
|
+
*/
|
|
41
|
+
protected abstract setVariable<TValue>(name: string, value: TValue): IResult<TValue>;
|
|
42
|
+
/**
|
|
43
|
+
* Вызвать публичную функцию.
|
|
44
|
+
* @param name - Имя функции.
|
|
45
|
+
* @param id - Уникальный идентификатор.
|
|
46
|
+
* @param args - Аргументы вызова.
|
|
47
|
+
*/
|
|
48
|
+
protected abstract callFunction<TReturns = unknown>(name: string, id: string, args: any[]): IResult<TReturns>;
|
|
49
|
+
/**
|
|
50
|
+
* Ожидать завершения обещания.
|
|
51
|
+
* @param channel - Канал обработки обещания.
|
|
52
|
+
* @param id - Уникальный идентификатор.
|
|
53
|
+
*/
|
|
54
|
+
protected abstract waitPromise<TReturns = unknown>(channel: string, id?: string): Promise<TReturns>;
|
|
55
|
+
/**
|
|
56
|
+
* Вызвать событие.
|
|
57
|
+
* @param name - Имя события.
|
|
58
|
+
* @param value - Передаваемое значение.
|
|
59
|
+
*/
|
|
60
|
+
protected abstract emitEvent<TValue = unknown>(name: string, value?: TValue): void;
|
|
61
|
+
/**
|
|
62
|
+
* Добавить обработчик события.
|
|
63
|
+
* @param name - Имя события.
|
|
64
|
+
* @param type - Тип события.
|
|
65
|
+
* @param handler - Обработчик события.
|
|
66
|
+
* @returns Функция отписки от события.
|
|
67
|
+
*/
|
|
68
|
+
protected abstract handleEvent<TValue = unknown>(name: string, type: 'on' | 'once', handler: EventListener<IResult<TValue>>): EventUnsubscribe;
|
|
69
|
+
/**
|
|
70
|
+
* Инициализация моста.
|
|
71
|
+
*/
|
|
72
|
+
protected init(): void;
|
|
73
|
+
/**
|
|
74
|
+
* Обработать возможную ошибку.
|
|
75
|
+
*
|
|
76
|
+
* Бросает ошибку если она была передана.
|
|
77
|
+
* @param channel - IPC канал.
|
|
78
|
+
* @param error - Возможная ошибка (текст).
|
|
79
|
+
*/
|
|
80
|
+
protected handlePossibleError(channel: string, error?: string): void | never;
|
|
81
|
+
/**
|
|
82
|
+
* Инициализировать доступ к публичным функциям.
|
|
83
|
+
*/
|
|
84
|
+
protected initFunctions(): void;
|
|
85
|
+
/**
|
|
86
|
+
* Инициализировать доступ к публичным переменным.
|
|
87
|
+
*/
|
|
88
|
+
protected initVariables(): void;
|
|
89
|
+
/**
|
|
90
|
+
* Добавить сущность в `target`.
|
|
91
|
+
* @param name - Имя.
|
|
92
|
+
* @param descriptor - Дескриптор значения.
|
|
93
|
+
*/
|
|
94
|
+
protected define<TValue = unknown>(name: string, descriptor?: TypedPropertyDescriptor<TValue>): void;
|
|
95
|
+
}
|
|
@@ -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;
|
|
@@ -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; } });
|