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,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;
@@ -1,8 +1,8 @@
1
- import type { Target } from '../types';
1
+ import type { IBridge } from '../types.js';
2
2
  /**
3
3
  * Bridge between `renderer` and `main` processes.
4
4
  *
5
5
  * _only for renderer process_
6
6
  */
7
- declare let Bridge: Target;
8
- export default Bridge;
7
+ declare const _default: IBridge;
8
+ export default _default;
@@ -3,55 +3,67 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
3
3
  return (mod && mod.__esModule) ? mod : { "default": mod };
4
4
  };
5
5
  Object.defineProperty(exports, "__esModule", { value: true });
6
- const enums_1 = require("../enums");
7
- const errors_1 = require("../errors");
8
- const provider_1 = __importDefault(require("./provider"));
9
- /**
10
- * Bridge between `renderer` and `main` processes.
11
- *
12
- * _only for renderer process_
13
- */
14
- let Bridge = new Proxy({ as: () => throwError() }, {
15
- get: () => throwError(),
16
- set: () => throwError(),
17
- apply: () => throwError()
18
- });
19
- class ProviderIntoRenderer extends provider_1.default {
20
- #globalProvider = window.__provider__;
21
- constructor() { super(); this.init(); }
22
- info = this.#globalProvider.getInfo();
23
- scope = enums_1.Scope.renderer;
24
- callFunction(name, secret, args) {
25
- return this.#globalProvider.provided.functions[name](secret, args);
6
+ const errors_js_1 = require("../errors.js");
7
+ const index_js_1 = require("./helpers/index.js");
8
+ const provider_js_1 = __importDefault(require("./provider.js"));
9
+ class ProviderIntoRenderer extends provider_js_1.default {
10
+ globalProvider;
11
+ entitiesInfo;
12
+ constructor() {
13
+ super();
14
+ if (!window.__provider__) {
15
+ throw new errors_js_1.NotProvidedFromMain();
16
+ }
17
+ this.globalProvider = window.__provider__;
18
+ this.entitiesInfo = this.globalProvider.getEntitiesInfo();
19
+ this.init();
20
+ }
21
+ callFunction(name, id, args) {
22
+ return this.globalProvider.entities.functions[name](id, args);
26
23
  }
27
24
  getVariable(name) {
28
- return this.#globalProvider.provided.properties[name].get();
25
+ return this.globalProvider.entities.variables[name].get();
29
26
  }
30
27
  setVariable(name, value) {
31
- return this.#globalProvider.provided.properties[name].set(value);
28
+ return this.globalProvider.entities.variables[name].set(value);
32
29
  }
33
- waitPromise(channel, secret) {
30
+ waitPromise(channel, id) {
34
31
  return new Promise((resolve, reject) => {
35
- this.#globalProvider.waitPromise(channel, resolve, reject, secret);
32
+ this.globalProvider.waitPromise(channel, resolve, reject, id);
36
33
  });
37
34
  }
38
- handleMainEvent(name, type, handler) {
39
- return this.#globalProvider.provided.mainEvents[name](type, handler);
35
+ handleEvent(name, type, listener) {
36
+ return type === 'on'
37
+ ? this.globalProvider.entities.events.on(name, listener)
38
+ : this.globalProvider.entities.events.once(name, listener);
40
39
  }
41
- emitRendererEvent(name, arg) {
42
- this.#globalProvider.provided.rendererEvents[name](arg);
40
+ emitEvent(name, value) {
41
+ this.globalProvider.entities.events.emit(name, value);
43
42
  }
44
43
  }
45
- /** Выбрасывает ошибку если используется не в том процессе */
46
- let throwError;
47
- if (typeof window === 'undefined') {
48
- throwError = () => { throw new errors_1.TryUseBridgeInPreload(); };
49
- }
50
- else if (!window.__provider__) {
51
- throwError = () => { throw new errors_1.GlobalProviderNotFoundError(); };
44
+ function getErrorThrower() {
45
+ if (!index_js_1.Env.global.hasWindow) {
46
+ return index_js_1.ErrorThrower.throws(errors_js_1.TryUseBridgeInPreload);
47
+ }
48
+ if (!index_js_1.Env.global.hasProvider) {
49
+ return index_js_1.ErrorThrower.throws(errors_js_1.GlobalProviderNotFoundError);
50
+ }
51
+ return null;
52
52
  }
53
- else {
54
- // Выполняется только в web
55
- Bridge = new ProviderIntoRenderer();
53
+ function getBridge() {
54
+ const throwError = getErrorThrower();
55
+ if (throwError) {
56
+ return new Proxy({}, {
57
+ get: throwError,
58
+ set: throwError,
59
+ apply: throwError
60
+ });
61
+ }
62
+ return new ProviderIntoRenderer();
56
63
  }
57
- exports.default = Bridge;
64
+ /**
65
+ * Bridge between `renderer` and `main` processes.
66
+ *
67
+ * _only for renderer process_
68
+ */
69
+ exports.default = getBridge();
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Хелпер для работы с исполняемым окружением.
3
+ */
4
+ export default class Env {
5
+ /**
6
+ * Есть ли объект `window`.
7
+ */
8
+ static get hasWindow(): boolean;
9
+ /**
10
+ * Есть ли провайдер необходимых методов из `preload` в `renderer`. (`window.__provider__`)
11
+ */
12
+ static get hasProvider(): boolean;
13
+ /**
14
+ * Является ли окружение `preload` процессом.
15
+ *
16
+ * Работает корректно только если запущено в `preload` или `renderer`.
17
+ */
18
+ static get isPreload(): boolean;
19
+ }
@@ -0,0 +1,28 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ /**
4
+ * Хелпер для работы с исполняемым окружением.
5
+ */
6
+ class Env {
7
+ /**
8
+ * Есть ли объект `window`.
9
+ */
10
+ static get hasWindow() {
11
+ return typeof window !== 'undefined';
12
+ }
13
+ /**
14
+ * Есть ли провайдер необходимых методов из `preload` в `renderer`. (`window.__provider__`)
15
+ */
16
+ static get hasProvider() {
17
+ return Boolean(window.__provider__);
18
+ }
19
+ /**
20
+ * Является ли окружение `preload` процессом.
21
+ *
22
+ * Работает корректно только если запущено в `preload` или `renderer`.
23
+ */
24
+ static get isPreload() {
25
+ return typeof global !== 'undefined';
26
+ }
27
+ }
28
+ exports.default = Env;
@@ -0,0 +1,3 @@
1
+ export default class ErrorThrower {
2
+ static throws<TClass extends new (...args: TArgs) => InstanceType<TClass>, TArgs extends any[]>(errorClass: TClass, ...args: TArgs): () => never;
3
+ }
@@ -0,0 +1,8 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ class ErrorThrower {
4
+ static throws(errorClass, ...args) {
5
+ return () => { throw new errorClass(...args); };
6
+ }
7
+ }
8
+ exports.default = ErrorThrower;
@@ -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; } });
@@ -0,0 +1,75 @@
1
+ /**
2
+ * Хелпер для работы с каналом IPC.
3
+ */
4
+ export default class IpcChannel {
5
+ /**
6
+ * Информация о публичных сущностях.
7
+ */
8
+ static readonly publicInfo: {
9
+ /**
10
+ * Получить канал получения информации.
11
+ * @returns Канал получения информации
12
+ */
13
+ get: () => string;
14
+ };
15
+ /**
16
+ * Публичная функция.
17
+ */
18
+ static readonly func: {
19
+ /**
20
+ * Получить канал вызова функции.
21
+ * @param name - Имя функции.
22
+ * @returns Канал вызова функции.
23
+ */
24
+ call: (name: string) => string;
25
+ };
26
+ /**
27
+ * Публичное событие.
28
+ */
29
+ static readonly event: {
30
+ /**
31
+ * Получить канал отслеживания события.
32
+ * @returns Канал отслеживания события.
33
+ */
34
+ on: () => string;
35
+ /**
36
+ * Получить канал однократного отслеживания события.
37
+ * @returns Канал однократного отслеживания события.
38
+ */
39
+ once: () => string;
40
+ /**
41
+ * Получить канал вызова события.
42
+ * @param name - Название события.
43
+ * @returns Канал вызова события.
44
+ */
45
+ emit: (name: string) => string;
46
+ };
47
+ /**
48
+ * Публичное свойство.
49
+ */
50
+ static readonly prop: {
51
+ /**
52
+ * Получить канал получения значения свойства.
53
+ * @param name - Имя свойства.
54
+ * @returns Канал получения значения свойства.
55
+ */
56
+ get: (name: string) => string;
57
+ /**
58
+ * Получить канал установки значения свойства.
59
+ * @param name - Имя свойства.
60
+ * @returns Канал получения установки значения свойства.
61
+ */
62
+ set: (name: string) => string;
63
+ };
64
+ /**
65
+ * Обещание.
66
+ */
67
+ static readonly promise: {
68
+ /**
69
+ * Получить канал обработки обещания.
70
+ * @param channel - Канал, который возвращает обещание.
71
+ * @returns Канал обработки обещания.
72
+ */
73
+ get: (channel: string) => string;
74
+ };
75
+ }
@@ -0,0 +1,78 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ /**
4
+ * Хелпер для работы с каналом IPC.
5
+ */
6
+ class IpcChannel {
7
+ }
8
+ /**
9
+ * Информация о публичных сущностях.
10
+ */
11
+ IpcChannel.publicInfo = {
12
+ /**
13
+ * Получить канал получения информации.
14
+ * @returns Канал получения информации
15
+ */
16
+ get: () => 'GET_PUBLIC_INFO'
17
+ };
18
+ /**
19
+ * Публичная функция.
20
+ */
21
+ IpcChannel.func = {
22
+ /**
23
+ * Получить канал вызова функции.
24
+ * @param name - Имя функции.
25
+ * @returns Канал вызова функции.
26
+ */
27
+ call: (name) => `FUNCTION_CALL_${name}`
28
+ };
29
+ /**
30
+ * Публичное событие.
31
+ */
32
+ IpcChannel.event = {
33
+ /**
34
+ * Получить канал отслеживания события.
35
+ * @returns Канал отслеживания события.
36
+ */
37
+ on: () => 'EVENT_ON',
38
+ /**
39
+ * Получить канал однократного отслеживания события.
40
+ * @returns Канал однократного отслеживания события.
41
+ */
42
+ once: () => 'EVENT_ONCE',
43
+ /**
44
+ * Получить канал вызова события.
45
+ * @param name - Название события.
46
+ * @returns Канал вызова события.
47
+ */
48
+ emit: (name) => `EVENT_EMIT_${name}`
49
+ };
50
+ /**
51
+ * Публичное свойство.
52
+ */
53
+ IpcChannel.prop = {
54
+ /**
55
+ * Получить канал получения значения свойства.
56
+ * @param name - Имя свойства.
57
+ * @returns Канал получения значения свойства.
58
+ */
59
+ get: (name) => `PROPERTY_GET_${name}`,
60
+ /**
61
+ * Получить канал установки значения свойства.
62
+ * @param name - Имя свойства.
63
+ * @returns Канал получения установки значения свойства.
64
+ */
65
+ set: (name) => `PROPERTY_SET_${name}`
66
+ };
67
+ /**
68
+ * Обещание.
69
+ */
70
+ IpcChannel.promise = {
71
+ /**
72
+ * Получить канал обработки обещания.
73
+ * @param channel - Канал, который возвращает обещание.
74
+ * @returns Канал обработки обещания.
75
+ */
76
+ get: (channel) => `${channel}_PROMISE`
77
+ };
78
+ exports.default = IpcChannel;
@@ -0,0 +1,24 @@
1
+ import type { IpcMainEvent } from 'electron';
2
+ import type { IResult } from '../../types.js';
3
+ /**
4
+ * Событие вызова IPC в `main` процессе.
5
+ */
6
+ export default class IpcEventInMain {
7
+ private event;
8
+ /**
9
+ * Создать событие вызова IPC в `main` процессе.
10
+ * @param event - Оригинальное IPC событие.
11
+ */
12
+ constructor(event: IpcMainEvent);
13
+ /**
14
+ * Отправить сообщение в канал `renderer` процесса.
15
+ * @param channel - IPC канал.
16
+ * @param result - Отправляемый результат.
17
+ */
18
+ send(channel: string, result: IResult): void;
19
+ /**
20
+ * Вернуть результат вызова IPC.
21
+ * @param value - Результат.
22
+ */
23
+ return(value: any): void;
24
+ }
@@ -0,0 +1,30 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ /**
4
+ * Событие вызова IPC в `main` процессе.
5
+ */
6
+ class IpcEventInMain {
7
+ /**
8
+ * Создать событие вызова IPC в `main` процессе.
9
+ * @param event - Оригинальное IPC событие.
10
+ */
11
+ constructor(event) {
12
+ this.event = event;
13
+ }
14
+ /**
15
+ * Отправить сообщение в канал `renderer` процесса.
16
+ * @param channel - IPC канал.
17
+ * @param result - Отправляемый результат.
18
+ */
19
+ send(channel, result) {
20
+ this.event.sender.send(channel, result);
21
+ }
22
+ /**
23
+ * Вернуть результат вызова IPC.
24
+ * @param value - Результат.
25
+ */
26
+ return(value) {
27
+ this.event.returnValue = value;
28
+ }
29
+ }
30
+ exports.default = IpcEventInMain;
@@ -0,0 +1,26 @@
1
+ import type { IResult } from '../../types.js';
2
+ /**
3
+ * Хелпер для работы с результатом IPC.
4
+ */
5
+ export default class IpcResult {
6
+ /**
7
+ * Создать результат с обещанием.
8
+ * @param promiseChannel - Канал обработки обещания.
9
+ * @returns Результат с обещанием.
10
+ */
11
+ static createWithPromise(promiseChannel: string): IResult;
12
+ /**
13
+ * Создать результат со значением.
14
+ * @param value - Значение. **Должно быть передаваемым**.
15
+ * @param id - Уникальный идентификатор.
16
+ * @returns Результат со значением.
17
+ */
18
+ static createWithValue<T = unknown>(value: T, id?: string): IResult;
19
+ /**
20
+ * Создать результат с ошибкой.
21
+ * @param error - Ошибка.
22
+ * @param id - Уникальный идентификатор.
23
+ * @returns Результат с ошибкой.
24
+ */
25
+ static createWithError(error?: Error | string, id?: string): IResult;
26
+ }