emr-bridge 1.7.0 → 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.
Files changed (159) 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/enums.d.ts +5 -14
  12. package/cjs/enums.js +12 -23
  13. package/cjs/errors.d.ts +42 -10
  14. package/cjs/errors.js +77 -23
  15. package/cjs/index.d.ts +4 -4
  16. package/cjs/index.js +14 -16
  17. package/cjs/main.d.ts +2 -4
  18. package/cjs/main.js +7 -16
  19. package/cjs/preload.d.ts +3 -3
  20. package/cjs/preload.js +5 -5
  21. package/cjs/renderer.d.ts +2 -2
  22. package/cjs/renderer.js +2 -2
  23. package/cjs/scripts/base-bridge.d.ts +95 -0
  24. package/cjs/scripts/base-bridge.js +128 -0
  25. package/cjs/scripts/bridge.d.ts +3 -3
  26. package/cjs/scripts/bridge.js +51 -39
  27. package/cjs/scripts/helpers/env.d.ts +19 -0
  28. package/cjs/scripts/helpers/env.js +28 -0
  29. package/cjs/scripts/helpers/error-thrower.d.ts +3 -0
  30. package/cjs/scripts/helpers/error-thrower.js +8 -0
  31. package/cjs/scripts/helpers/errors.d.ts +12 -0
  32. package/cjs/scripts/helpers/errors.js +17 -0
  33. package/cjs/scripts/helpers/id.d.ts +9 -0
  34. package/cjs/scripts/helpers/id.js +14 -0
  35. package/cjs/scripts/helpers/index.d.ts +8 -0
  36. package/cjs/scripts/helpers/index.js +22 -0
  37. package/cjs/scripts/helpers/ipc-channel.d.ts +75 -0
  38. package/cjs/scripts/helpers/ipc-channel.js +78 -0
  39. package/cjs/scripts/helpers/ipc-event-in-main.d.ts +24 -0
  40. package/cjs/scripts/helpers/ipc-event-in-main.js +30 -0
  41. package/cjs/scripts/helpers/ipc-result.d.ts +26 -0
  42. package/cjs/scripts/helpers/ipc-result.js +48 -0
  43. package/cjs/scripts/helpers/main-event.d.ts +8 -0
  44. package/cjs/scripts/helpers/main-event.js +15 -0
  45. package/cjs/scripts/helpers/transfer.d.ts +33 -0
  46. package/cjs/scripts/helpers/transfer.js +57 -0
  47. package/cjs/scripts/helpers/web-contents-container.d.ts +12 -0
  48. package/cjs/scripts/helpers/web-contents-container.js +34 -0
  49. package/cjs/scripts/helpers/web-contents-events-container.d.ts +56 -0
  50. package/cjs/scripts/helpers/web-contents-events-container.js +81 -0
  51. package/cjs/scripts/main/publish.d.ts +36 -0
  52. package/cjs/scripts/main/publish.js +186 -0
  53. package/cjs/scripts/preload/bridge.d.ts +27 -0
  54. package/cjs/scripts/preload/bridge.js +85 -0
  55. package/cjs/scripts/preload/provider.d.ts +7 -0
  56. package/cjs/scripts/preload/provider.js +89 -0
  57. package/cjs/scripts/preload-bridge.d.ts +20 -0
  58. package/cjs/scripts/preload-bridge.js +76 -0
  59. package/cjs/scripts/preload-provider.js +37 -53
  60. package/cjs/scripts/provider.d.ts +17 -15
  61. package/cjs/scripts/provider.js +70 -91
  62. package/cjs/scripts/publish.d.ts +19 -18
  63. package/cjs/scripts/publish.js +97 -175
  64. package/cjs/scripts/renderer/bridge.d.ts +6 -0
  65. package/cjs/scripts/renderer/bridge.js +74 -0
  66. package/cjs/scripts/renderer/tunnels.d.ts +171 -0
  67. package/cjs/scripts/renderer/tunnels.js +205 -0
  68. package/cjs/scripts/renderer-tunnels.d.ts +19 -21
  69. package/cjs/scripts/renderer-tunnels.js +53 -58
  70. package/cjs/types.d.ts +189 -64
  71. package/esm/entries/index.d.ts +1 -0
  72. package/esm/entries/index.js +5 -0
  73. package/esm/entries/main.d.ts +2 -0
  74. package/esm/entries/main.js +5 -0
  75. package/esm/entries/preload.d.ts +3 -0
  76. package/esm/entries/preload.js +7 -0
  77. package/esm/entries/renderer.d.ts +2 -0
  78. package/esm/entries/renderer.js +6 -0
  79. package/esm/enums.d.ts +5 -14
  80. package/esm/enums.js +11 -22
  81. package/esm/errors.d.ts +42 -10
  82. package/esm/errors.js +69 -16
  83. package/esm/helpers.d.ts +41 -0
  84. package/esm/helpers.js +96 -0
  85. package/esm/index.d.ts +4 -4
  86. package/esm/index.js +3 -3
  87. package/esm/main.d.ts +2 -4
  88. package/esm/main.js +1 -3
  89. package/esm/preload.d.ts +3 -3
  90. package/esm/preload.js +2 -2
  91. package/esm/renderer.d.ts +2 -2
  92. package/esm/renderer.js +1 -1
  93. package/esm/scripts/base-bridge.d.ts +95 -0
  94. package/esm/scripts/base-bridge.js +125 -0
  95. package/esm/scripts/bridge.d.ts +3 -3
  96. package/esm/scripts/bridge.js +50 -38
  97. package/esm/scripts/helpers/electron-importer.d.ts +4 -0
  98. package/esm/scripts/helpers/electron-importer.js +16 -0
  99. package/esm/scripts/helpers/env.d.ts +19 -0
  100. package/esm/scripts/helpers/env.js +25 -0
  101. package/esm/scripts/helpers/error-thrower.d.ts +3 -0
  102. package/esm/scripts/helpers/error-thrower.js +5 -0
  103. package/esm/scripts/helpers/errors.d.ts +12 -0
  104. package/esm/scripts/helpers/errors.js +14 -0
  105. package/esm/scripts/helpers/id.d.ts +9 -0
  106. package/esm/scripts/helpers/id.js +11 -0
  107. package/esm/scripts/helpers/index.d.ts +8 -0
  108. package/esm/scripts/helpers/index.js +8 -0
  109. package/esm/scripts/helpers/ipc-channel.d.ts +75 -0
  110. package/esm/scripts/helpers/ipc-channel.js +76 -0
  111. package/esm/scripts/helpers/ipc-event-in-main.d.ts +24 -0
  112. package/esm/scripts/helpers/ipc-event-in-main.js +27 -0
  113. package/esm/scripts/helpers/ipc-result.d.ts +26 -0
  114. package/esm/scripts/helpers/ipc-result.js +42 -0
  115. package/esm/scripts/helpers/main-event.d.ts +8 -0
  116. package/esm/scripts/helpers/main-event.js +12 -0
  117. package/esm/scripts/helpers/transfer.d.ts +33 -0
  118. package/esm/scripts/helpers/transfer.js +54 -0
  119. package/esm/scripts/helpers/web-contents-container.d.ts +12 -0
  120. package/esm/scripts/helpers/web-contents-container.js +31 -0
  121. package/esm/scripts/helpers/web-contents-events-container.d.ts +56 -0
  122. package/esm/scripts/helpers/web-contents-events-container.js +78 -0
  123. package/esm/scripts/main/publish.d.ts +36 -0
  124. package/esm/scripts/main/publish.js +179 -0
  125. package/esm/scripts/main.d.ts +3 -3
  126. package/esm/scripts/main.js +43 -41
  127. package/esm/scripts/preload/bridge.d.ts +27 -0
  128. package/esm/scripts/preload/bridge.js +77 -0
  129. package/esm/scripts/preload/provider.d.ts +7 -0
  130. package/esm/scripts/preload/provider.js +84 -0
  131. package/esm/scripts/preload-bridge.d.ts +20 -0
  132. package/esm/scripts/preload-bridge.js +68 -0
  133. package/esm/scripts/preload-provider.js +35 -51
  134. package/esm/scripts/provider.d.ts +17 -15
  135. package/esm/scripts/provider.js +70 -91
  136. package/esm/scripts/publish.d.ts +19 -18
  137. package/esm/scripts/publish.js +89 -162
  138. package/esm/scripts/renderer/bridge.d.ts +6 -0
  139. package/esm/scripts/renderer/bridge.js +69 -0
  140. package/esm/scripts/renderer/tunnels.d.ts +171 -0
  141. package/esm/scripts/renderer/tunnels.js +203 -0
  142. package/esm/scripts/renderer-tunnels.d.ts +19 -21
  143. package/esm/scripts/renderer-tunnels.js +53 -55
  144. package/esm/types.d.ts +189 -64
  145. package/package.json +24 -41
  146. package/cjs/exp.d.ts +0 -4
  147. package/cjs/exp.js +0 -19
  148. package/cjs/scripts/main.d.ts +0 -8
  149. package/cjs/scripts/main.js +0 -72
  150. package/cjs/scripts/new-decorators.d.ts +0 -150
  151. package/cjs/scripts/new-decorators.js +0 -141
  152. package/cjs/scripts/old-decorators.d.ts +0 -185
  153. package/cjs/scripts/old-decorators.js +0 -132
  154. package/esm/exp.d.ts +0 -4
  155. package/esm/exp.js +0 -3
  156. package/esm/scripts/new-decorators.d.ts +0 -150
  157. package/esm/scripts/new-decorators.js +0 -132
  158. package/esm/scripts/old-decorators.d.ts +0 -185
  159. package/esm/scripts/old-decorators.js +0 -122
@@ -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/enums.d.ts CHANGED
@@ -1,19 +1,10 @@
1
- export declare enum Access {
2
- get = "get",
3
- set = "set"
4
- }
5
- export declare enum Scope {
6
- renderer = "renderer",
7
- preload = "preload"
8
- }
9
- export declare enum IPCChannel {
1
+ export declare enum IpcChannel {
10
2
  getPublicInfo = "GET_PUBLIC_INFO",
11
3
  functionCall = "FUNCTION_CALL_",
12
- mainEventOn = "MAIN_EVENT_ON_",
13
- mainEventOnce = "MAIN_EVENT_ONCE_",
14
- mainEventEmit = "MAIN_EVENT_EMIT_",
4
+ eventOn = "EVENT_ON",
5
+ eventOnce = "EVENT_ONCE",
6
+ eventEmit = "EVENT_EMIT_",
15
7
  propertyGet = "PROPERTY_GET_",
16
8
  propertySet = "PROPERTY_SET_",
17
- promisePostfix = "_PROMISE",
18
- rendererEventEmit = "RENDERER_EMIT_"
9
+ promisePostfix = "_PROMISE"
19
10
  }
package/cjs/enums.js CHANGED
@@ -1,25 +1,14 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.IPCChannel = exports.Scope = exports.Access = void 0;
4
- var Access;
5
- (function (Access) {
6
- Access["get"] = "get";
7
- Access["set"] = "set";
8
- })(Access || (exports.Access = Access = {}));
9
- var Scope;
10
- (function (Scope) {
11
- Scope["renderer"] = "renderer";
12
- Scope["preload"] = "preload";
13
- })(Scope || (exports.Scope = Scope = {}));
14
- var IPCChannel;
15
- (function (IPCChannel) {
16
- IPCChannel["getPublicInfo"] = "GET_PUBLIC_INFO";
17
- IPCChannel["functionCall"] = "FUNCTION_CALL_";
18
- IPCChannel["mainEventOn"] = "MAIN_EVENT_ON_";
19
- IPCChannel["mainEventOnce"] = "MAIN_EVENT_ONCE_";
20
- IPCChannel["mainEventEmit"] = "MAIN_EVENT_EMIT_";
21
- IPCChannel["propertyGet"] = "PROPERTY_GET_";
22
- IPCChannel["propertySet"] = "PROPERTY_SET_";
23
- IPCChannel["promisePostfix"] = "_PROMISE";
24
- IPCChannel["rendererEventEmit"] = "RENDERER_EMIT_";
25
- })(IPCChannel || (exports.IPCChannel = IPCChannel = {}));
3
+ exports.IpcChannel = void 0;
4
+ var IpcChannel;
5
+ (function (IpcChannel) {
6
+ IpcChannel["getPublicInfo"] = "GET_PUBLIC_INFO";
7
+ IpcChannel["functionCall"] = "FUNCTION_CALL_";
8
+ IpcChannel["eventOn"] = "EVENT_ON";
9
+ IpcChannel["eventOnce"] = "EVENT_ONCE";
10
+ IpcChannel["eventEmit"] = "EVENT_EMIT_";
11
+ IpcChannel["propertyGet"] = "PROPERTY_GET_";
12
+ IpcChannel["propertySet"] = "PROPERTY_SET_";
13
+ IpcChannel["promisePostfix"] = "_PROMISE";
14
+ })(IpcChannel || (exports.IpcChannel = IpcChannel = {}));
package/cjs/errors.d.ts CHANGED
@@ -1,28 +1,60 @@
1
- import { Scope } from './enums';
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;
package/cjs/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export { Access, Scope } from './enums';
2
- export { publicClassMainEvent, publicClassRendererEvent, publicGetter, publicMethod, publicProperty, publicSetter } from './scripts/new-decorators';
3
- export { publicFunction, publicMainEvent, publicRendererEvent, publicVariable } from './scripts/publish';
4
- export type { EventEmitter, EventHandler, EventReceiver, EventUnsubscriber, MainEvent, PublicFunction, PublicProperty, PublishMainEventArgs, PublishMethodArgs, PublishPropertyArgs, PublishRendererEventArgs, RendererEvent } from './types';
1
+ export { default as Bridge } from './scripts/bridge.js';
2
+ export { default as provideFromMain } from './scripts/preload-provider.js';
3
+ export { emitEvent, on, once, publicFunction, publicVariable } from './scripts/publish.js';
4
+ export type { EventListener, EventUnsubscribe, IPublicProperty, PublicFunction } from './types.js';
package/cjs/index.js CHANGED
@@ -1,18 +1,16 @@
1
1
  "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
2
5
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.publicVariable = exports.publicRendererEvent = exports.publicMainEvent = exports.publicFunction = exports.publicSetter = exports.publicProperty = exports.publicMethod = exports.publicGetter = exports.publicClassRendererEvent = exports.publicClassMainEvent = exports.Scope = exports.Access = void 0;
4
- var enums_1 = require("./enums");
5
- Object.defineProperty(exports, "Access", { enumerable: true, get: function () { return enums_1.Access; } });
6
- Object.defineProperty(exports, "Scope", { enumerable: true, get: function () { return enums_1.Scope; } });
7
- var new_decorators_1 = require("./scripts/new-decorators");
8
- Object.defineProperty(exports, "publicClassMainEvent", { enumerable: true, get: function () { return new_decorators_1.publicClassMainEvent; } });
9
- Object.defineProperty(exports, "publicClassRendererEvent", { enumerable: true, get: function () { return new_decorators_1.publicClassRendererEvent; } });
10
- Object.defineProperty(exports, "publicGetter", { enumerable: true, get: function () { return new_decorators_1.publicGetter; } });
11
- Object.defineProperty(exports, "publicMethod", { enumerable: true, get: function () { return new_decorators_1.publicMethod; } });
12
- Object.defineProperty(exports, "publicProperty", { enumerable: true, get: function () { return new_decorators_1.publicProperty; } });
13
- Object.defineProperty(exports, "publicSetter", { enumerable: true, get: function () { return new_decorators_1.publicSetter; } });
14
- var publish_1 = require("./scripts/publish");
15
- Object.defineProperty(exports, "publicFunction", { enumerable: true, get: function () { return publish_1.publicFunction; } });
16
- Object.defineProperty(exports, "publicMainEvent", { enumerable: true, get: function () { return publish_1.publicMainEvent; } });
17
- Object.defineProperty(exports, "publicRendererEvent", { enumerable: true, get: function () { return publish_1.publicRendererEvent; } });
18
- Object.defineProperty(exports, "publicVariable", { enumerable: true, get: function () { return publish_1.publicVariable; } });
6
+ exports.publicVariable = exports.publicFunction = exports.once = exports.on = exports.emitEvent = exports.provideFromMain = exports.Bridge = void 0;
7
+ var bridge_js_1 = require("./scripts/bridge.js");
8
+ Object.defineProperty(exports, "Bridge", { enumerable: true, get: function () { return __importDefault(bridge_js_1).default; } });
9
+ var preload_provider_js_1 = require("./scripts/preload-provider.js");
10
+ Object.defineProperty(exports, "provideFromMain", { enumerable: true, get: function () { return __importDefault(preload_provider_js_1).default; } });
11
+ var publish_js_1 = require("./scripts/publish.js");
12
+ Object.defineProperty(exports, "emitEvent", { enumerable: true, get: function () { return publish_js_1.emitEvent; } });
13
+ Object.defineProperty(exports, "on", { enumerable: true, get: function () { return publish_js_1.on; } });
14
+ Object.defineProperty(exports, "once", { enumerable: true, get: function () { return publish_js_1.once; } });
15
+ Object.defineProperty(exports, "publicFunction", { enumerable: true, get: function () { return publish_js_1.publicFunction; } });
16
+ Object.defineProperty(exports, "publicVariable", { enumerable: true, get: function () { return publish_js_1.publicVariable; } });
package/cjs/main.d.ts CHANGED
@@ -1,4 +1,2 @@
1
- export { Access, Scope } from './enums';
2
- export { publicClassMainEvent, publicClassRendererEvent, publicGetter, publicMethod, publicProperty, publicSetter } from './scripts/new-decorators';
3
- export { publicFunction, publicMainEvent, publicRendererEvent, publicVariable } from './scripts/publish';
4
- export type { EventEmitter, EventHandler, EventReceiver, EventUnsubscriber, MainEvent, PublicFunction, PublicProperty, PublishMainEventArgs, PublishMethodArgs, PublishPropertyArgs, PublishRendererEventArgs, RendererEvent } from './types';
1
+ export { emitEvent, on, once, publicFunction, publicVariable } from './scripts/publish.js';
2
+ export type { EventListener, EventUnsubscribe, IPublicProperty, PublicFunction } from './types.js';
package/cjs/main.js CHANGED
@@ -1,18 +1,9 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.publicVariable = exports.publicRendererEvent = exports.publicMainEvent = exports.publicFunction = exports.publicSetter = exports.publicProperty = exports.publicMethod = exports.publicGetter = exports.publicClassRendererEvent = exports.publicClassMainEvent = exports.Scope = exports.Access = void 0;
4
- var enums_1 = require("./enums");
5
- Object.defineProperty(exports, "Access", { enumerable: true, get: function () { return enums_1.Access; } });
6
- Object.defineProperty(exports, "Scope", { enumerable: true, get: function () { return enums_1.Scope; } });
7
- var new_decorators_1 = require("./scripts/new-decorators");
8
- Object.defineProperty(exports, "publicClassMainEvent", { enumerable: true, get: function () { return new_decorators_1.publicClassMainEvent; } });
9
- Object.defineProperty(exports, "publicClassRendererEvent", { enumerable: true, get: function () { return new_decorators_1.publicClassRendererEvent; } });
10
- Object.defineProperty(exports, "publicGetter", { enumerable: true, get: function () { return new_decorators_1.publicGetter; } });
11
- Object.defineProperty(exports, "publicMethod", { enumerable: true, get: function () { return new_decorators_1.publicMethod; } });
12
- Object.defineProperty(exports, "publicProperty", { enumerable: true, get: function () { return new_decorators_1.publicProperty; } });
13
- Object.defineProperty(exports, "publicSetter", { enumerable: true, get: function () { return new_decorators_1.publicSetter; } });
14
- var publish_1 = require("./scripts/publish");
15
- Object.defineProperty(exports, "publicFunction", { enumerable: true, get: function () { return publish_1.publicFunction; } });
16
- Object.defineProperty(exports, "publicMainEvent", { enumerable: true, get: function () { return publish_1.publicMainEvent; } });
17
- Object.defineProperty(exports, "publicRendererEvent", { enumerable: true, get: function () { return publish_1.publicRendererEvent; } });
18
- Object.defineProperty(exports, "publicVariable", { enumerable: true, get: function () { return publish_1.publicVariable; } });
3
+ exports.publicVariable = exports.publicFunction = exports.once = exports.on = exports.emitEvent = void 0;
4
+ var publish_js_1 = require("./scripts/publish.js");
5
+ Object.defineProperty(exports, "emitEvent", { enumerable: true, get: function () { return publish_js_1.emitEvent; } });
6
+ Object.defineProperty(exports, "on", { enumerable: true, get: function () { return publish_js_1.on; } });
7
+ Object.defineProperty(exports, "once", { enumerable: true, get: function () { return publish_js_1.once; } });
8
+ Object.defineProperty(exports, "publicFunction", { enumerable: true, get: function () { return publish_js_1.publicFunction; } });
9
+ Object.defineProperty(exports, "publicVariable", { enumerable: true, get: function () { return publish_js_1.publicVariable; } });
package/cjs/preload.d.ts CHANGED
@@ -1,3 +1,3 @@
1
- export { default as Main } from './scripts/main';
2
- export { default as provideFromMain } from './scripts/preload-provider';
3
- export type { EventEmitter, EventHandler, EventReceiver, EventUnsubscriber, MainEvent, PublicFunction, PublicProperty, PublishMainEventArgs, PublishMethodArgs, PublishPropertyArgs, PublishRendererEventArgs, RendererEvent } from './types';
1
+ export { default as Bridge } from './scripts/preload-bridge.js';
2
+ export { default as provideFromMain } from './scripts/preload-provider.js';
3
+ export type { EventListener, EventUnsubscribe, IPublicProperty, PublicFunction } from './types.js';
package/cjs/preload.js CHANGED
@@ -3,8 +3,8 @@ 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
- exports.provideFromMain = exports.Main = void 0;
7
- var main_1 = require("./scripts/main");
8
- Object.defineProperty(exports, "Main", { enumerable: true, get: function () { return __importDefault(main_1).default; } });
9
- var preload_provider_1 = require("./scripts/preload-provider");
10
- Object.defineProperty(exports, "provideFromMain", { enumerable: true, get: function () { return __importDefault(preload_provider_1).default; } });
6
+ exports.provideFromMain = exports.Bridge = void 0;
7
+ var preload_bridge_js_1 = require("./scripts/preload-bridge.js");
8
+ Object.defineProperty(exports, "Bridge", { enumerable: true, get: function () { return __importDefault(preload_bridge_js_1).default; } });
9
+ var preload_provider_js_1 = require("./scripts/preload-provider.js");
10
+ Object.defineProperty(exports, "provideFromMain", { enumerable: true, get: function () { return __importDefault(preload_provider_js_1).default; } });
package/cjs/renderer.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export { default as Bridge } from './scripts/bridge';
2
- export type { EventEmitter, EventHandler, EventReceiver, EventUnsubscriber, MainEvent, PublicFunction, PublicProperty, PublishMainEventArgs, PublishMethodArgs, PublishPropertyArgs, PublishRendererEventArgs, RendererEvent } from './types';
1
+ export { default as Bridge } from './scripts/bridge.js';
2
+ export type { EventListener, EventUnsubscribe, IPublicProperty, PublicFunction } from './types.js';
package/cjs/renderer.js CHANGED
@@ -4,5 +4,5 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
4
4
  };
5
5
  Object.defineProperty(exports, "__esModule", { value: true });
6
6
  exports.Bridge = void 0;
7
- var bridge_1 = require("./scripts/bridge");
8
- Object.defineProperty(exports, "Bridge", { enumerable: true, get: function () { return __importDefault(bridge_1).default; } });
7
+ var bridge_js_1 = require("./scripts/bridge.js");
8
+ Object.defineProperty(exports, "Bridge", { enumerable: true, get: function () { return __importDefault(bridge_js_1).default; } });
@@ -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
+ }