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,179 @@
1
+ /*
2
+ Методы публикации в main процессе.
3
+ */
4
+ import { ipcMain } from 'electron';
5
+ import { PublishMethodsUnavailableError } from '../../errors.js';
6
+ import { Env, Errors, IpcChannel, IpcEventInMain, IpcResult, Transfer, WebContentsEventsContainer } from '../helpers/index.js';
7
+ /**
8
+ * Информация о сущностях.
9
+ */
10
+ const entitiesInfo = {
11
+ variables: new Set(),
12
+ functions: new Set()
13
+ };
14
+ /**
15
+ * Контейнер отправителей для событий.
16
+ */
17
+ const eventsContainer = new WebContentsEventsContainer();
18
+ /**
19
+ * Выбросить ошибку если есть причина.
20
+ */
21
+ const canThrowError = (Env.hasWindow || !ipcMain)
22
+ ? Errors.getThrower(PublishMethodsUnavailableError)
23
+ : () => { };
24
+ if (ipcMain) {
25
+ ipcMain.on(IpcChannel.publicInfo.get(), event => new IpcEventInMain(event).return(entitiesInfo));
26
+ ipcMain.on(IpcChannel.event.on(), (event, { value }) => eventsContainer.addOn(value, event.sender));
27
+ ipcMain.on(IpcChannel.event.once(), (event, { value }) => eventsContainer.addOn(value, event.sender));
28
+ }
29
+ /**
30
+ * Вызвать событие из main процесса.
31
+ * @param name - Имя события.
32
+ * @param value - Передаваемое значение.
33
+ */
34
+ export function emitEvent(name, value) {
35
+ canThrowError();
36
+ const emitChannel = IpcChannel.event.emit(name);
37
+ try {
38
+ if (value instanceof Promise) {
39
+ value
40
+ .then(val => {
41
+ for (const sender of eventsContainer.getAll(name)) {
42
+ sender.send(emitChannel, IpcResult.createWithValue(val));
43
+ }
44
+ eventsContainer.clearOnce(name);
45
+ })
46
+ .catch(reason => {
47
+ eventsContainer.getAll(name).forEach(sender => sender.send(emitChannel, IpcResult.createWithError(reason)));
48
+ eventsContainer.clearOnce(name);
49
+ });
50
+ return;
51
+ }
52
+ for (const sender of eventsContainer.getAll(name)) {
53
+ sender.send(emitChannel, IpcResult.createWithValue(value));
54
+ }
55
+ eventsContainer.clearOnce(name);
56
+ }
57
+ catch (error) {
58
+ eventsContainer.getAll(name).forEach(sender => sender.send(emitChannel, IpcResult.createWithError(error)));
59
+ eventsContainer.clearOnce(name);
60
+ }
61
+ }
62
+ /**
63
+ * Добавить обработчик renderer события.
64
+ * @param name - Имя события.
65
+ * @param listener - Обработчик.
66
+ * @param receives - Принимаемые классы, недоступные для транспортировки по умолчанию. _Порядок важен._
67
+ * @returns Функция отписки от события.
68
+ */
69
+ export function on(name, listener, receives) {
70
+ canThrowError();
71
+ const emitChannel = IpcChannel.event.emit(name);
72
+ const handler = (_, { value }) => {
73
+ if (Transfer.isSnapshotValue(value)) {
74
+ listener(Transfer.getFromSnapshot(value, receives));
75
+ }
76
+ else {
77
+ listener(value);
78
+ }
79
+ };
80
+ ipcMain.on(emitChannel, handler);
81
+ return () => ipcMain.removeListener(emitChannel, handler);
82
+ }
83
+ /**
84
+ * Добавить одноразовый обработчик renderer события.
85
+ * @param name - Имя события.
86
+ * @param listener - Обработчик.
87
+ * @param receives - Класс передаваемого значения, если оно не может быть передано стандартным способом.
88
+ * @returns Функция отписки от события.
89
+ */
90
+ export function once(name, listener, receives) {
91
+ canThrowError();
92
+ const emitChannel = IpcChannel.event.emit(name);
93
+ const handler = (_, { value }) => {
94
+ if (Transfer.isSnapshotValue(value)) {
95
+ listener(Transfer.getFromSnapshot(value, receives));
96
+ }
97
+ else {
98
+ listener(value);
99
+ }
100
+ };
101
+ ipcMain.once(emitChannel, handler);
102
+ return () => ipcMain.removeListener(emitChannel, handler);
103
+ }
104
+ /**
105
+ * Опубликовать (сделать доступной) функцию из main процесса.
106
+ * @param name - Имя, по которому будет доступна функция в renderer процессе.
107
+ * @param func - Публикуемая функция.
108
+ * @param receives - Принимаемые классы, недоступные для транспортировки по умолчанию. _Порядок важен._
109
+ */
110
+ export function publishFunction(name, func, receives = []) {
111
+ canThrowError();
112
+ const channel = IpcChannel.func.call(name);
113
+ entitiesInfo.functions.add(name);
114
+ ipcMain.removeAllListeners(channel);
115
+ ipcMain.on(channel, (e, { args, id }) => {
116
+ const event = new IpcEventInMain(e);
117
+ const receivesCopy = [...receives];
118
+ try {
119
+ const preparedArgs = args.map(arg => (Transfer.isSnapshotValue(arg) && receivesCopy[0]
120
+ ? Transfer.getFromSnapshot(arg, receivesCopy.shift())
121
+ : arg));
122
+ const result = func(...preparedArgs);
123
+ if (result instanceof Promise) {
124
+ const promiseChannel = IpcChannel.promise.get(channel);
125
+ result
126
+ .then(value => event.send(promiseChannel, IpcResult.createWithValue(value, id)))
127
+ .catch(reason => event.send(promiseChannel, IpcResult.createWithError(reason, id)));
128
+ event.return(IpcResult.createWithPromise(promiseChannel));
129
+ }
130
+ else {
131
+ event.return(IpcResult.createWithValue(result));
132
+ }
133
+ }
134
+ catch (error) {
135
+ event.return(IpcResult.createWithError(error));
136
+ }
137
+ });
138
+ }
139
+ /**
140
+ * Опубликовать (сделать доступной) переменную из main процесса.
141
+ * @param name - Имя переменной, по которому она будет доступна в renderer процессе.
142
+ * @param descriptor - Дескриптор. Используется только get/set/value.
143
+ */
144
+ export function publishVariable(name, descriptor) {
145
+ canThrowError();
146
+ const getChannel = IpcChannel.prop.get(name);
147
+ const setChannel = IpcChannel.prop.set(name);
148
+ const { set: setter, value } = descriptor;
149
+ let { get: getter } = descriptor;
150
+ entitiesInfo.variables.add(name);
151
+ if (value) {
152
+ getter = () => value;
153
+ }
154
+ if (getter) {
155
+ ipcMain.removeAllListeners(getChannel);
156
+ ipcMain.on(getChannel, e => {
157
+ const event = new IpcEventInMain(e);
158
+ try {
159
+ event.return(IpcResult.createWithValue(getter()));
160
+ }
161
+ catch (error) {
162
+ event.return(IpcResult.createWithError(error));
163
+ }
164
+ });
165
+ }
166
+ if (setter) {
167
+ ipcMain.removeAllListeners(setChannel);
168
+ ipcMain.on(setChannel, (e, { args }) => {
169
+ const event = new IpcEventInMain(e);
170
+ try {
171
+ setter(args.at(0));
172
+ event.return(IpcResult.createWithValue(null));
173
+ }
174
+ catch (error) {
175
+ event.return(IpcResult.createWithError(error));
176
+ }
177
+ });
178
+ }
179
+ }
@@ -1,8 +1,8 @@
1
- import type { Target } from '../types';
1
+ import type { IBridge } from '../types.js';
2
2
  /**
3
3
  * Bridge between `preload` and `main` processes.
4
4
  *
5
5
  * _only for preload process_
6
6
  */
7
- declare let Main: Target;
8
- export default Main;
7
+ declare const _default: IBridge;
8
+ export default _default;
@@ -1,29 +1,21 @@
1
1
  import electron from 'electron';
2
- import { IPCChannel, Scope } from '../enums';
3
- import { NotProvidedFromMain, TryUseMainInMain, TryUseMainInRenderer } from '../errors';
4
- import Provider from './provider';
5
- import IPCTunnel from './renderer-tunnels';
6
- /**
7
- * Bridge between `preload` and `main` processes.
8
- *
9
- * _only for preload process_
10
- */
11
- let Main = new Proxy({ as() { throwError(); } }, {
12
- get() { throwError(); },
13
- set() { throwError(); },
14
- apply() { throwError(); }
15
- });
2
+ import { IpcChannel } from '../enums.js';
3
+ import { NotProvidedFromMain, TryUseMainInMain } from '../errors.js';
4
+ import { Env, ErrorThrower } from '../helpers.js';
5
+ import Provider from './provider.js';
6
+ import IPCTunnel from './renderer-tunnels.js';
7
+ const ipcRenderer = electron.ipcRenderer;
16
8
  class ProviderIntoPreload extends Provider {
17
- #ipcRenderer = electron.ipcRenderer;
18
- info = this.#ipcRenderer.sendSync(IPCChannel.getPublicInfo);
19
- scope = Scope.preload;
9
+ entitiesInfo = ipcRenderer.sendSync(IpcChannel.getPublicInfo);
20
10
  constructor() {
21
11
  super();
22
- if (!this.info)
12
+ if (!this.entitiesInfo) {
23
13
  throw new NotProvidedFromMain();
14
+ }
15
+ this.init();
24
16
  }
25
17
  callFunction(name, secret, args) {
26
- return new IPCTunnel.Function(name).call({ args, secret });
18
+ return new IPCTunnel.Function(name).call({ args, id: secret });
27
19
  }
28
20
  getVariable(name) {
29
21
  return new IPCTunnel.Property(name).get();
@@ -31,20 +23,20 @@ class ProviderIntoPreload extends Provider {
31
23
  setVariable(name, value) {
32
24
  return new IPCTunnel.Property(name).set(value);
33
25
  }
34
- async waitPromise(channel, secret) {
35
- return await new IPCTunnel.Promise(channel).wait(secret);
26
+ async waitPromise(channel, id) {
27
+ return await new IPCTunnel.Promise(channel).wait(id);
36
28
  }
37
- handleMainEvent(name, type, handler) {
38
- const tunnel = new IPCTunnel.MainEvent(name);
39
- if (type === 'on')
40
- return tunnel.on(handler);
41
- else
42
- return tunnel.once(handler);
29
+ handleEvent(name, type, listener) {
30
+ const tunnel = new IPCTunnel.Event(name);
31
+ return type === 'on'
32
+ ? tunnel.on(listener)
33
+ : tunnel.once(listener);
43
34
  }
44
- emitRendererEvent(name, arg) {
45
- const tunnel = new IPCTunnel.RendererEvent(name);
35
+ emitEvent(name, arg) {
36
+ const tunnel = new IPCTunnel.Event(name);
46
37
  if (arg instanceof Promise) {
47
- arg.then(value => tunnel.emit(value))
38
+ arg
39
+ .then(value => tunnel.emit(value))
48
40
  .catch(reason => tunnel.error(String(reason)));
49
41
  }
50
42
  else {
@@ -52,16 +44,26 @@ class ProviderIntoPreload extends Provider {
52
44
  }
53
45
  }
54
46
  }
55
- /** Выбрасывает ошибку если используется не в том процессе */
56
- let throwError;
57
- if (typeof window !== 'undefined') {
58
- throwError = () => { throw new TryUseMainInRenderer(); };
59
- }
60
- else if (!('ipcRenderer' in electron)) {
61
- throwError = () => { throw new TryUseMainInMain(); };
47
+ function getErrorThrower() {
48
+ if (!Env.electron.hasIpcRenderer) {
49
+ return ErrorThrower.throws(TryUseMainInMain);
50
+ }
51
+ return null;
62
52
  }
63
- else {
64
- // Выполняется только в NodeJS
65
- Main = new ProviderIntoPreload();
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 ProviderIntoPreload();
66
63
  }
67
- export default Main;
64
+ /**
65
+ * Bridge between `preload` and `main` processes.
66
+ *
67
+ * _only for preload process_
68
+ */
69
+ export default getBridge();
@@ -0,0 +1,27 @@
1
+ import type { EventListener, EventUnsubscribe, IBridge, IResult } from '../../types.js';
2
+ import BaseBridge from '../base-bridge.js';
3
+ /**
4
+ * Мост preload-main.
5
+ */
6
+ export declare class PreloadBridge extends BaseBridge {
7
+ protected readonly entitiesInfo: any;
8
+ /**
9
+ * Создать мост preload-main.
10
+ */
11
+ constructor();
12
+ protected callFunction(name: string, secret: string, args: any[]): IResult;
13
+ protected getVariable(name: string): IResult;
14
+ protected setVariable(name: string, value: any): IResult;
15
+ protected waitPromise(channel: string, id?: string): Promise<any>;
16
+ protected handleEvent(name: string, type: 'on' | 'once', listener: EventListener<IResult>): EventUnsubscribe;
17
+ protected emitEvent(name: string, value: any): void;
18
+ }
19
+ /**
20
+ * Получить мост preload-main.
21
+ */
22
+ export declare function getBridge(): IBridge;
23
+ /**
24
+ * Мост preload-main.
25
+ */
26
+ declare const _default: IBridge;
27
+ export default _default;
@@ -0,0 +1,77 @@
1
+ import { ipcRenderer } from 'electron';
2
+ import { NotProvidedFromMainError, TryUseBridgeInMainError } from '../../errors.js';
3
+ import BaseBridge from '../base-bridge.js';
4
+ import { Errors, IpcChannel, Transfer } from '../helpers/index.js';
5
+ import IPCTunnel from '../renderer/tunnels.js';
6
+ /**
7
+ * Мост preload-main.
8
+ */
9
+ export class PreloadBridge extends BaseBridge {
10
+ /**
11
+ * Создать мост preload-main.
12
+ */
13
+ constructor() {
14
+ super();
15
+ this.entitiesInfo = ipcRenderer.sendSync(IpcChannel.publicInfo.get());
16
+ if (!this.entitiesInfo) {
17
+ throw new NotProvidedFromMainError();
18
+ }
19
+ this.init();
20
+ }
21
+ callFunction(name, secret, args) {
22
+ return new IPCTunnel.Function(name).call({ args, id: secret });
23
+ }
24
+ getVariable(name) {
25
+ return new IPCTunnel.Variable(name).get();
26
+ }
27
+ setVariable(name, value) {
28
+ return new IPCTunnel.Variable(name).set(value);
29
+ }
30
+ async waitPromise(channel, id) {
31
+ return await new IPCTunnel.Promise(channel).wait(id);
32
+ }
33
+ handleEvent(name, type, listener) {
34
+ const tunnel = new IPCTunnel.Event(name);
35
+ return type === 'on'
36
+ ? tunnel.on(listener)
37
+ : tunnel.once(listener);
38
+ }
39
+ emitEvent(name, value) {
40
+ const tunnel = new IPCTunnel.Event(name);
41
+ if (value instanceof Promise) {
42
+ value
43
+ .then(val => tunnel.emit(Transfer.toTransferable(val)))
44
+ .catch(reason => tunnel.error(String(reason)));
45
+ }
46
+ else {
47
+ tunnel.emit(value);
48
+ }
49
+ }
50
+ }
51
+ /**
52
+ * Получить функцию бросающую исключение если есть повод.
53
+ */
54
+ function getErrorThrower() {
55
+ if (!ipcRenderer) {
56
+ return Errors.getThrower(TryUseBridgeInMainError);
57
+ }
58
+ return null;
59
+ }
60
+ /**
61
+ * Получить мост preload-main.
62
+ */
63
+ export function getBridge() {
64
+ const throwError = getErrorThrower();
65
+ if (throwError) {
66
+ return new Proxy({}, {
67
+ get: throwError,
68
+ set: throwError,
69
+ apply: throwError
70
+ });
71
+ }
72
+ return new PreloadBridge();
73
+ }
74
+ /**
75
+ * Мост preload-main.
76
+ */
77
+ export default getBridge();
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Добавляет необходимые для работы функции.
3
+ *
4
+ * @param contextIsolation - Изоляция контекста. _По умолчанию_: `true`
5
+ */
6
+ declare function provideFromMain(contextIsolation?: boolean): void;
7
+ export default provideFromMain;
@@ -0,0 +1,84 @@
1
+ import { contextBridge, ipcRenderer } from 'electron';
2
+ import { NotProvidedFromMainError, TryProvideInMainError, TryProvideInRendererError } from '../../errors.js';
3
+ import { Errors, IpcChannel, Transfer } from '../helpers/index.js';
4
+ import IPCTunnel from '../renderer/tunnels.js';
5
+ /**
6
+ * Бросить ошибку если есть повод.
7
+ */
8
+ let throwPossibleError = () => { };
9
+ if (!ipcRenderer) {
10
+ throwPossibleError = Errors.getThrower(TryProvideInMainError);
11
+ }
12
+ else if (!contextBridge) {
13
+ throwPossibleError = Errors.getThrower(TryProvideInRendererError);
14
+ }
15
+ /**
16
+ * Добавляет необходимые для работы функции.
17
+ *
18
+ * @param contextIsolation - Изоляция контекста. _По умолчанию_: `true`
19
+ */
20
+ function provideFromMain(contextIsolation = true) {
21
+ throwPossibleError();
22
+ const entitiesInfo = ipcRenderer.sendSync(IpcChannel.publicInfo.get());
23
+ if (!entitiesInfo) {
24
+ throw new NotProvidedFromMainError();
25
+ }
26
+ const provider = {
27
+ getEntitiesInfo: () => entitiesInfo,
28
+ waitPromise: (channel, resolve, reject, id) => (new IPCTunnel.Promise(channel).wait(id)
29
+ .then(resolve)
30
+ .catch(reject)),
31
+ entities: {
32
+ functions: getFunctions(),
33
+ variables: getVariables(),
34
+ events: {
35
+ emit: (name, value) => {
36
+ const tunnel = new IPCTunnel.Event(name);
37
+ if (value instanceof Promise) {
38
+ value
39
+ .then(val => tunnel.emit(Transfer.toTransferable(val)))
40
+ .catch(reason => tunnel.error(String(reason)));
41
+ }
42
+ else {
43
+ tunnel.emit(value);
44
+ }
45
+ },
46
+ on: (name, listener) => new IPCTunnel.Event(name).on(listener),
47
+ once: (name, listener) => new IPCTunnel.Event(name).once(listener)
48
+ }
49
+ }
50
+ };
51
+ if (contextIsolation) {
52
+ contextBridge.exposeInMainWorld('__provider__', provider);
53
+ }
54
+ else {
55
+ window.__provider__ = provider;
56
+ }
57
+ /**
58
+ * Получить доступ к публичным функциям.
59
+ */
60
+ function getFunctions() {
61
+ const result = {};
62
+ for (const name of entitiesInfo.functions) {
63
+ result[name] = (id, args) => {
64
+ return new IPCTunnel.Function(name).call({ args, id: id });
65
+ };
66
+ }
67
+ return result;
68
+ }
69
+ /**
70
+ * Получить доступ к публичным переменным.
71
+ */
72
+ function getVariables() {
73
+ const result = {};
74
+ for (const name of entitiesInfo.variables) {
75
+ const tunnel = new IPCTunnel.Variable(name);
76
+ result[name] = {
77
+ get: () => tunnel.get(),
78
+ set: (value) => tunnel.set(value)
79
+ };
80
+ }
81
+ return result;
82
+ }
83
+ }
84
+ export default provideFromMain;
@@ -0,0 +1,20 @@
1
+ import type { EventListener, EventUnsubscribe, IBridge, IResult } from '../types.js';
2
+ import Provider from './provider.js';
3
+ export declare class ProviderIntoPreload extends Provider {
4
+ protected readonly entitiesInfo: any;
5
+ constructor();
6
+ protected callFunction(name: string, secret: string, args: any[]): IResult;
7
+ protected getVariable(name: string): IResult;
8
+ protected setVariable(name: string, value: any): IResult;
9
+ protected waitPromise(channel: string, id?: string): Promise<any>;
10
+ protected handleEvent(name: string, type: 'on' | 'once', listener: EventListener<IResult>): EventUnsubscribe;
11
+ protected emitEvent(name: string, arg: any): void;
12
+ }
13
+ export declare function getBridge(): IBridge;
14
+ /**
15
+ * Bridge between `preload` and `main` processes.
16
+ *
17
+ * _only for preload process_
18
+ */
19
+ declare const _default: IBridge;
20
+ export default _default;
@@ -0,0 +1,68 @@
1
+ import { ipcRenderer } from 'electron';
2
+ import { IpcChannel } from '../enums.js';
3
+ import { NotProvidedFromMain, TryUseMainInMain } from '../errors.js';
4
+ import { ErrorThrower } from './helpers/index.js';
5
+ import Provider from './provider.js';
6
+ import IPCTunnel from './renderer-tunnels.js';
7
+ export class ProviderIntoPreload extends Provider {
8
+ entitiesInfo = ipcRenderer.sendSync(IpcChannel.getPublicInfo);
9
+ constructor() {
10
+ super();
11
+ if (!this.entitiesInfo) {
12
+ throw new NotProvidedFromMain();
13
+ }
14
+ this.init();
15
+ }
16
+ callFunction(name, secret, args) {
17
+ return new IPCTunnel.Function(name).call({ args, id: secret });
18
+ }
19
+ getVariable(name) {
20
+ return new IPCTunnel.Property(name).get();
21
+ }
22
+ setVariable(name, value) {
23
+ return new IPCTunnel.Property(name).set(value);
24
+ }
25
+ async waitPromise(channel, id) {
26
+ return await new IPCTunnel.Promise(channel).wait(id);
27
+ }
28
+ handleEvent(name, type, listener) {
29
+ const tunnel = new IPCTunnel.Event(name);
30
+ return type === 'on'
31
+ ? tunnel.on(listener)
32
+ : tunnel.once(listener);
33
+ }
34
+ emitEvent(name, arg) {
35
+ const tunnel = new IPCTunnel.Event(name);
36
+ if (arg instanceof Promise) {
37
+ arg
38
+ .then(value => tunnel.emit(value))
39
+ .catch(reason => tunnel.error(String(reason)));
40
+ }
41
+ else {
42
+ tunnel.emit(arg);
43
+ }
44
+ }
45
+ }
46
+ function getErrorThrower() {
47
+ if (!ipcRenderer) {
48
+ return ErrorThrower.throws(TryUseMainInMain);
49
+ }
50
+ return null;
51
+ }
52
+ export function getBridge() {
53
+ const throwError = getErrorThrower();
54
+ if (throwError) {
55
+ return new Proxy({}, {
56
+ get: throwError,
57
+ set: throwError,
58
+ apply: throwError
59
+ });
60
+ }
61
+ return new ProviderIntoPreload();
62
+ }
63
+ /**
64
+ * Bridge between `preload` and `main` processes.
65
+ *
66
+ * _only for preload process_
67
+ */
68
+ export default getBridge();