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.
Files changed (141) hide show
  1. package/LICENCE +1 -1
  2. package/README.md +173 -366
  3. package/cjs/entries/index.d.ts +1 -0
  4. package/cjs/entries/index.js +6 -0
  5. package/cjs/entries/main.d.ts +2 -0
  6. package/cjs/entries/main.js +27 -0
  7. package/cjs/entries/preload.d.ts +3 -0
  8. package/cjs/entries/preload.js +29 -0
  9. package/cjs/entries/renderer.d.ts +2 -0
  10. package/cjs/entries/renderer.js +27 -0
  11. package/cjs/errors.d.ts +42 -10
  12. package/cjs/errors.js +77 -23
  13. package/cjs/scripts/base-bridge.d.ts +95 -0
  14. package/cjs/scripts/base-bridge.js +128 -0
  15. package/cjs/scripts/helpers/env.d.ts +19 -0
  16. package/cjs/scripts/helpers/env.js +28 -0
  17. package/cjs/scripts/helpers/errors.d.ts +12 -0
  18. package/cjs/scripts/helpers/errors.js +17 -0
  19. package/cjs/scripts/helpers/id.d.ts +9 -0
  20. package/cjs/scripts/helpers/id.js +14 -0
  21. package/cjs/scripts/helpers/index.d.ts +8 -0
  22. package/cjs/scripts/helpers/index.js +22 -0
  23. package/cjs/scripts/helpers/ipc-channel.d.ts +75 -0
  24. package/cjs/scripts/helpers/ipc-channel.js +78 -0
  25. package/cjs/scripts/helpers/ipc-event-in-main.d.ts +24 -0
  26. package/cjs/scripts/helpers/ipc-event-in-main.js +30 -0
  27. package/cjs/scripts/helpers/ipc-result.d.ts +26 -0
  28. package/cjs/scripts/helpers/ipc-result.js +48 -0
  29. package/cjs/scripts/helpers/transfer.d.ts +33 -0
  30. package/cjs/scripts/helpers/transfer.js +57 -0
  31. package/cjs/scripts/helpers/web-contents-events-container.d.ts +51 -0
  32. package/cjs/scripts/helpers/web-contents-events-container.js +75 -0
  33. package/cjs/scripts/main/publish.d.ts +36 -0
  34. package/cjs/scripts/main/publish.js +184 -0
  35. package/cjs/scripts/preload/bridge.d.ts +27 -0
  36. package/cjs/scripts/preload/bridge.js +85 -0
  37. package/cjs/scripts/preload/provider.d.ts +7 -0
  38. package/cjs/scripts/preload/provider.js +89 -0
  39. package/cjs/scripts/renderer/bridge.d.ts +6 -0
  40. package/cjs/scripts/renderer/bridge.js +74 -0
  41. package/cjs/scripts/renderer/tunnels.d.ts +171 -0
  42. package/cjs/scripts/renderer/tunnels.js +205 -0
  43. package/cjs/types.d.ts +189 -64
  44. package/esm/entries/index.d.ts +1 -0
  45. package/esm/entries/index.js +5 -0
  46. package/esm/entries/main.d.ts +2 -0
  47. package/esm/entries/main.js +5 -0
  48. package/esm/entries/preload.d.ts +3 -0
  49. package/esm/entries/preload.js +7 -0
  50. package/esm/entries/renderer.d.ts +2 -0
  51. package/esm/entries/renderer.js +6 -0
  52. package/esm/errors.d.ts +42 -10
  53. package/esm/errors.js +69 -16
  54. package/esm/scripts/base-bridge.d.ts +95 -0
  55. package/esm/scripts/base-bridge.js +125 -0
  56. package/esm/scripts/helpers/env.d.ts +19 -0
  57. package/esm/scripts/helpers/env.js +25 -0
  58. package/esm/scripts/helpers/errors.d.ts +12 -0
  59. package/esm/scripts/helpers/errors.js +14 -0
  60. package/esm/scripts/helpers/id.d.ts +9 -0
  61. package/esm/scripts/helpers/id.js +11 -0
  62. package/esm/scripts/helpers/index.d.ts +8 -0
  63. package/esm/scripts/helpers/index.js +8 -0
  64. package/esm/scripts/helpers/ipc-channel.d.ts +75 -0
  65. package/esm/scripts/helpers/ipc-channel.js +76 -0
  66. package/esm/scripts/helpers/ipc-event-in-main.d.ts +24 -0
  67. package/esm/scripts/helpers/ipc-event-in-main.js +27 -0
  68. package/esm/scripts/helpers/ipc-result.d.ts +26 -0
  69. package/esm/scripts/helpers/ipc-result.js +42 -0
  70. package/esm/scripts/helpers/transfer.d.ts +33 -0
  71. package/esm/scripts/helpers/transfer.js +54 -0
  72. package/esm/scripts/helpers/web-contents-events-container.d.ts +51 -0
  73. package/esm/scripts/helpers/web-contents-events-container.js +72 -0
  74. package/esm/scripts/main/publish.d.ts +36 -0
  75. package/esm/scripts/main/publish.js +177 -0
  76. package/esm/scripts/preload/bridge.d.ts +27 -0
  77. package/esm/scripts/preload/bridge.js +77 -0
  78. package/esm/scripts/preload/provider.d.ts +7 -0
  79. package/esm/scripts/preload/provider.js +84 -0
  80. package/esm/scripts/renderer/bridge.d.ts +6 -0
  81. package/esm/scripts/renderer/bridge.js +69 -0
  82. package/esm/scripts/renderer/tunnels.d.ts +171 -0
  83. package/esm/scripts/renderer/tunnels.js +203 -0
  84. package/esm/types.d.ts +189 -64
  85. package/package.json +23 -41
  86. package/cjs/enums.d.ts +0 -19
  87. package/cjs/enums.js +0 -25
  88. package/cjs/exp.d.ts +0 -4
  89. package/cjs/exp.js +0 -19
  90. package/cjs/index.d.ts +0 -4
  91. package/cjs/index.js +0 -18
  92. package/cjs/main.d.ts +0 -4
  93. package/cjs/main.js +0 -18
  94. package/cjs/preload.d.ts +0 -3
  95. package/cjs/preload.js +0 -10
  96. package/cjs/renderer.d.ts +0 -2
  97. package/cjs/renderer.js +0 -8
  98. package/cjs/scripts/bridge.d.ts +0 -8
  99. package/cjs/scripts/bridge.js +0 -57
  100. package/cjs/scripts/main.d.ts +0 -8
  101. package/cjs/scripts/main.js +0 -72
  102. package/cjs/scripts/new-decorators.d.ts +0 -150
  103. package/cjs/scripts/new-decorators.js +0 -141
  104. package/cjs/scripts/old-decorators.d.ts +0 -185
  105. package/cjs/scripts/old-decorators.js +0 -132
  106. package/cjs/scripts/preload-provider.d.ts +0 -7
  107. package/cjs/scripts/preload-provider.js +0 -96
  108. package/cjs/scripts/provider.d.ts +0 -25
  109. package/cjs/scripts/provider.js +0 -116
  110. package/cjs/scripts/publish.d.ts +0 -40
  111. package/cjs/scripts/publish.js +0 -232
  112. package/cjs/scripts/renderer-tunnels.d.ts +0 -47
  113. package/cjs/scripts/renderer-tunnels.js +0 -115
  114. package/esm/enums.d.ts +0 -19
  115. package/esm/enums.js +0 -22
  116. package/esm/exp.d.ts +0 -4
  117. package/esm/exp.js +0 -3
  118. package/esm/index.d.ts +0 -4
  119. package/esm/index.js +0 -3
  120. package/esm/main.d.ts +0 -4
  121. package/esm/main.js +0 -3
  122. package/esm/preload.d.ts +0 -3
  123. package/esm/preload.js +0 -2
  124. package/esm/renderer.d.ts +0 -2
  125. package/esm/renderer.js +0 -1
  126. package/esm/scripts/bridge.d.ts +0 -8
  127. package/esm/scripts/bridge.js +0 -52
  128. package/esm/scripts/main.d.ts +0 -8
  129. package/esm/scripts/main.js +0 -67
  130. package/esm/scripts/new-decorators.d.ts +0 -150
  131. package/esm/scripts/new-decorators.js +0 -132
  132. package/esm/scripts/old-decorators.d.ts +0 -185
  133. package/esm/scripts/old-decorators.js +0 -122
  134. package/esm/scripts/preload-provider.d.ts +0 -7
  135. package/esm/scripts/preload-provider.js +0 -91
  136. package/esm/scripts/provider.d.ts +0 -25
  137. package/esm/scripts/provider.js +0 -113
  138. package/esm/scripts/publish.d.ts +0 -40
  139. package/esm/scripts/publish.js +0 -220
  140. package/esm/scripts/renderer-tunnels.d.ts +0 -47
  141. 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,3 @@
1
+ export { default as Bridge } from '../scripts/preload/bridge.js';
2
+ export { default as provideFromMain } from '../scripts/preload/provider.js';
3
+ export * from './index.js';
@@ -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,2 @@
1
+ export { default as Bridge } from '../scripts/renderer/bridge.js';
2
+ export * from './index.js';
@@ -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
- import { Scope } from './enums.js';
2
- export declare class NoSetAccessError extends Error {
3
- constructor(name: string);
4
- }
1
+ /**
2
+ * Нет доступа к получению переменной.
3
+ */
5
4
  export declare class NoGetAccessError extends Error {
6
5
  constructor(name: string);
7
6
  }
8
- export declare class NotProvidedIntoScopeError extends Error {
9
- constructor(name: string, scope: Scope);
7
+ /**
8
+ * Нет публичных сущностей.
9
+ */
10
+ export declare class NotProvidedFromMainError extends Error {
11
+ constructor();
10
12
  }
11
- export declare class NotProvidedFromMain extends Error {
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
- export declare class TryUseBridgeInPreload extends Error {
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
- export declare class TryUseMainInRenderer extends Error {
49
+ /**
50
+ * Попытка добавить провайдер в main процессе.
51
+ */
52
+ export declare class TryProvideInMainError extends Error {
24
53
  constructor();
25
54
  }
26
- export declare class TryUseMainInMain extends Error {
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.TryUseMainInMain = exports.TryUseMainInRenderer = exports.TryUseBridgeInPreload = exports.TrySetReadonlyError = exports.GlobalProviderNotFoundError = exports.NotProvidedFromMain = exports.NotProvidedIntoScopeError = exports.NoGetAccessError = exports.NoSetAccessError = void 0;
4
- class NoSetAccessError extends Error {
5
- constructor(name) { super(`No access to setting '${name}'`); }
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) { super(`No access to getting '${name}'`); }
8
+ constructor(name) {
9
+ super(`Нет доступа к получению '${name}'.`);
10
+ }
10
11
  }
11
12
  exports.NoGetAccessError = NoGetAccessError;
12
- class NotProvidedIntoScopeError extends Error {
13
- constructor(name, scope) { super(`'${name}' is not provided into ${scope} scope`); }
13
+ /**
14
+ * Нет публичных сущностей.
15
+ */
16
+ class NotProvidedFromMainError extends Error {
17
+ constructor() {
18
+ super('Публичные сущности не найдены. Добавьте их в main процессе.');
19
+ }
14
20
  }
15
- exports.NotProvidedIntoScopeError = NotProvidedIntoScopeError;
16
- class NotProvidedFromMain extends Error {
17
- constructor() { super('Public methods from main is not provided. Call any publish methods to provide it from main process.'); }
21
+ exports.NotProvidedFromMainError = NotProvidedFromMainError;
22
+ /**
23
+ * Публикация доступна только в main процессе.
24
+ */
25
+ class PublishMethodsUnavailableError extends Error {
26
+ constructor() {
27
+ super('Публикация доступна только в main процессе.');
28
+ }
18
29
  }
19
- exports.NotProvidedFromMain = NotProvidedFromMain;
30
+ exports.PublishMethodsUnavailableError = PublishMethodsUnavailableError;
31
+ /**
32
+ * Нет провайдера.
33
+ */
20
34
  class GlobalProviderNotFoundError extends Error {
21
- constructor() { super('Required methods not provided. Call "provideFromMain" in preload process.'); }
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) { super(`'${name}' is readonly`); }
44
+ constructor(name) {
45
+ super(`'${name}' доступно только для чтения.`);
46
+ }
26
47
  }
27
48
  exports.TrySetReadonlyError = TrySetReadonlyError;
28
- class TryUseBridgeInPreload extends Error {
29
- constructor() { super('"Bridge" is unavailable in main process. In preload use "Main" instead.'); }
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.TryUseBridgeInPreload = TryUseBridgeInPreload;
32
- class TryUseMainInRenderer extends Error {
33
- constructor() { super('"Main" is unavailable in renderer process. Use "Bridge" instead'); }
75
+ exports.TryUseBridgeInMainError = TryUseBridgeInMainError;
76
+ /**
77
+ * Попытка добавить провайдер в main процессе.
78
+ */
79
+ class TryProvideInMainError extends Error {
80
+ constructor() {
81
+ super('"provideFromMain" недоступен в main процессе.');
82
+ }
34
83
  }
35
- exports.TryUseMainInRenderer = TryUseMainInRenderer;
36
- class TryUseMainInMain extends Error {
37
- constructor() { super('"Main" is unavailable in main process.'); }
84
+ exports.TryProvideInMainError = TryProvideInMainError;
85
+ /**
86
+ * Попытка добавить провайдер в renderer процессе.
87
+ */
88
+ class TryProvideInRendererError extends Error {
89
+ constructor() {
90
+ super('"provideFromMain" недоступен в renderer процессе.');
91
+ }
38
92
  }
39
- exports.TryUseMainInMain = TryUseMainInMain;
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,9 @@
1
+ /**
2
+ * Хелпер для работы с идентификаторами.
3
+ */
4
+ export default class Id {
5
+ /**
6
+ * Создать новый идентификатор.
7
+ */
8
+ static new(): string;
9
+ }
@@ -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; } });