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
@@ -1,122 +1,73 @@
1
- import electron from 'electron';
2
- import { Access, IPCChannel, Scope } from '../enums';
3
- const publicInfo = {
4
- properties: new Set(),
5
- functions: new Set(),
6
- mainEvents: new Set(),
7
- rendererEvents: new Set(),
8
- accesses: new Map(),
9
- scopes: new Map()
1
+ import { ipcMain } from 'electron';
2
+ import { IpcChannel } from '../enums.js';
3
+ import { PublishMethodsUnavailable } from '../errors.js';
4
+ import { Env, ErrorThrower, IpcResult, MainEvent, Transfer, WebContentsContainer } from './helpers/index.js';
5
+ const entitiesInfo = {
6
+ variables: new Set(),
7
+ functions: new Set()
10
8
  };
9
+ const mainEventHandlers = new WebContentsContainer();
11
10
  /** Выбрасывает ошибку если используется не в том процессе */
12
- let mayThrowError = () => { };
13
- if (typeof window !== 'undefined' || !('ipcMain' in electron)) {
14
- mayThrowError = () => { throw new Error('Publish methods is available only in main process.'); };
15
- }
16
- else {
17
- electron.ipcMain.on(IPCChannel.getPublicInfo, e => e.returnValue = publicInfo);
18
- }
11
+ const canThrowError = (Env.global.hasWindow || !ipcMain)
12
+ ? ErrorThrower.throws(PublishMethodsUnavailable)
13
+ : () => { };
14
+ ipcMain?.on(IpcChannel.getPublicInfo, e => new MainEvent(e).return(entitiesInfo));
15
+ ipcMain?.on(IpcChannel.eventOn, (e, { value }) => mainEventHandlers.addOn(value, e.sender));
16
+ ipcMain?.on(IpcChannel.eventOnce, (e, { value }) => mainEventHandlers.addOn(value, e.sender));
19
17
  /**
20
- * Makes the event from **main** available for **renderer** and **preload** processes.
18
+ * Call the event from **main** process.
21
19
  *
22
- * @param name - name by which the event will be accessed
23
- * @param procFn - function of processing before sending the event
24
- * @param scopes - event scopes
20
+ * @param name - event name
25
21
  */
26
- export function publicMainEvent(name, procFn = ((...args) => args[0]), scopes = [Scope.preload, Scope.renderer]) {
27
- mayThrowError();
28
- const { ipcMain } = electron;
29
- const { mainEvents } = publicInfo;
30
- const mainEmitChannel = IPCChannel.mainEventEmit + name;
31
- const mainHandleChannel = IPCChannel.mainEventOn + name;
32
- const mainHandleChannelOnce = IPCChannel.mainEventOnce + name;
33
- let senders = [];
34
- let sendersOnce = [];
35
- mainEvents.add(name);
36
- const rendererNameOn = `on${name[0].toUpperCase()}${name.slice(1)}`;
37
- const rendererNameOnce = `once${name[0].toUpperCase()}${name.slice(1)}`;
38
- if (!publicInfo.scopes.has(rendererNameOn)) {
39
- publicInfo.scopes.set(rendererNameOn, new Set(scopes));
40
- publicInfo.scopes.set(rendererNameOnce, new Set(scopes));
41
- }
42
- ipcMain.removeAllListeners(mainHandleChannel);
43
- ipcMain.removeAllListeners(mainHandleChannelOnce);
44
- ipcMain.on(mainHandleChannel, ({ sender }) => !senders.includes(sender) && senders.push(sender));
45
- ipcMain.on(mainHandleChannelOnce, ({ sender }) => !sendersOnce.includes(sender) && sendersOnce.push(sender));
46
- return (...args) => {
47
- function filterSenders() {
48
- senders = senders.filter(sender => !sender.isDestroyed());
49
- sendersOnce = sendersOnce.filter(sender => !sender.isDestroyed());
22
+ export function emitEvent(name, value) {
23
+ canThrowError();
24
+ const emitChannel = IpcChannel.eventEmit + name;
25
+ try {
26
+ if (value instanceof Promise) {
27
+ value
28
+ .then(val => {
29
+ mainEventHandlers.getAll(name).forEach(sender => sender.send(emitChannel, IpcResult.withValue(val)));
30
+ mainEventHandlers.clearOnce(name);
31
+ })
32
+ .catch(reason => {
33
+ mainEventHandlers.getAll(name).forEach(sender => sender.send(emitChannel, IpcResult.withError(reason)));
34
+ mainEventHandlers.clearOnce(name);
35
+ });
36
+ return;
50
37
  }
51
- filterSenders();
52
- const allSenders = [...senders, ...sendersOnce];
53
- try {
54
- const result = procFn(...args);
55
- if (result instanceof Promise) {
56
- result
57
- .then(value => {
58
- filterSenders();
59
- [...senders, ...sendersOnce].forEach(sender => sender.send(mainEmitChannel, { value }));
60
- sendersOnce = [];
61
- })
62
- .catch(reason => {
63
- filterSenders();
64
- [...senders, ...sendersOnce].forEach(sender => sender.send(mainEmitChannel, { error: String(reason?.stack || reason) }));
65
- sendersOnce = [];
66
- });
67
- }
68
- else {
69
- allSenders.forEach(sender => sender.send(mainEmitChannel, { value: result }));
70
- sendersOnce = [];
71
- }
72
- }
73
- catch (error) {
74
- allSenders.forEach(sender => sender.send(mainEmitChannel, { error: String(error?.stack || error) }));
75
- sendersOnce = [];
76
- }
77
- };
38
+ mainEventHandlers.getAll(name).forEach(sender => sender.send(emitChannel, IpcResult.withValue(value)));
39
+ mainEventHandlers.clearOnce(name);
40
+ }
41
+ catch (error) {
42
+ mainEventHandlers.getAll(name).forEach(sender => sender.send(emitChannel, IpcResult.withError(error)));
43
+ mainEventHandlers.clearOnce(name);
44
+ }
78
45
  }
79
46
  /**
80
- * Makes the event from **renderer** and **preload** available for **main** process.
47
+ * Handle event from **main** process.
81
48
  *
82
- * @param name - name by which the event will be accessed
83
- * @param procFn - processing function before calling handlers
84
- * @param scopes - event scopes
49
+ * @param name - event name
50
+ * @param listener - event handler
85
51
  */
86
- export function publicRendererEvent(name, procFn = ((v) => v), scopes = [Scope.preload, Scope.renderer]) {
87
- mayThrowError();
88
- const { ipcMain } = electron;
89
- if (name.startsWith('on')) {
90
- name = name.replace('on', '');
91
- name = `${name[0].toLowerCase()}${name.slice(1)}`;
92
- }
93
- const { rendererEvents } = publicInfo;
94
- const rendererEmitChannel = IPCChannel.rendererEventEmit + name;
95
- const handlers = new Set();
96
- const handlersOnce = new Set();
97
- rendererEvents.add(name);
98
- if (!publicInfo.scopes.has(name)) {
99
- publicInfo.scopes.set(name, new Set(scopes));
100
- }
101
- ipcMain.removeAllListeners(rendererEmitChannel);
102
- ipcMain.on(rendererEmitChannel, (_, { error, value }) => {
103
- if (error)
104
- throw new Error(error);
105
- const converted = procFn(value);
106
- handlers.forEach(handler => handler(converted));
107
- handlersOnce.forEach(handler => handler(converted));
108
- handlersOnce.clear();
109
- });
110
- return (handler, isOnce = false) => {
111
- if (isOnce) {
112
- handlersOnce.add(handler);
113
- return () => handlersOnce.delete(handler);
114
- }
115
- else {
116
- handlers.add(handler);
117
- return () => handlers.delete(handler);
118
- }
119
- };
52
+ export function on(name, listener) {
53
+ canThrowError();
54
+ const emitChannel = IpcChannel.eventEmit + name;
55
+ const handler = (_, { value }) => listener(value);
56
+ ipcMain.on(emitChannel, handler);
57
+ return () => ipcMain.removeListener(emitChannel, handler);
58
+ }
59
+ /**
60
+ * Handle event from **main** process.
61
+ *
62
+ * @param name - event name
63
+ * @param listener - event handler
64
+ */
65
+ export function once(name, listener) {
66
+ canThrowError();
67
+ const emitChannel = IpcChannel.eventEmit + name;
68
+ const handler = (_, { value }) => listener(value);
69
+ ipcMain.once(emitChannel, handler);
70
+ return () => ipcMain.removeListener(emitChannel, handler);
120
71
  }
121
72
  /**
122
73
  * Makes the function available for **renderer** and **preload** processes.
@@ -125,34 +76,32 @@ export function publicRendererEvent(name, procFn = ((v) => v), scopes = [Scope.p
125
76
  *
126
77
  * @param name - name by which the function will be accessed
127
78
  * @param func - linked function
128
- * @param scopes - function scopes
129
79
  */
130
- export function publicFunction(name, func, scopes = [Scope.preload, Scope.renderer]) {
131
- mayThrowError();
132
- const { ipcMain } = electron;
133
- const { functions } = publicInfo;
134
- const channel = IPCChannel.functionCall + name;
135
- functions.add(name);
136
- if (!publicInfo.scopes.has(name)) {
137
- publicInfo.scopes.set(name, new Set(scopes));
138
- }
80
+ export function publicFunction(name, func, receives = []) {
81
+ canThrowError();
82
+ const channel = IpcChannel.functionCall + name;
83
+ entitiesInfo.functions.add(name);
139
84
  ipcMain.removeAllListeners(channel);
140
- ipcMain.on(channel, (e, { args, secret }) => {
85
+ ipcMain.on(channel, (e, { args, id }) => {
86
+ const event = new MainEvent(e);
141
87
  try {
142
- const result = func(...args);
88
+ const preparedArgs = args.map((arg, index) => (Transfer.isSnapshotValue(arg) && receives[index]
89
+ ? Transfer.getFromSnapshot(arg, receives[index])
90
+ : arg));
91
+ const result = func(...preparedArgs);
143
92
  if (result instanceof Promise) {
144
- const promiseChannel = channel + IPCChannel.promisePostfix;
93
+ const promiseChannel = channel + IpcChannel.promisePostfix;
145
94
  result
146
- .then(value => e.sender.send(promiseChannel, { value, secret }))
147
- .catch(reason => e.sender.send(promiseChannel, { error: String(reason?.stack || reason), secret }));
148
- e.returnValue = { promiseChannel };
95
+ .then(value => event.send(promiseChannel, IpcResult.withValue(value, id)))
96
+ .catch(reason => event.send(promiseChannel, IpcResult.withError(reason, id)));
97
+ event.return(IpcResult.withPromise(promiseChannel));
149
98
  }
150
99
  else {
151
- e.returnValue = { value: result };
100
+ event.return(IpcResult.withValue(result));
152
101
  }
153
102
  }
154
103
  catch (error) {
155
- e.returnValue = { error: String(error?.stack || error) };
104
+ event.return(IpcResult.withError(error));
156
105
  }
157
106
  });
158
107
  }
@@ -163,58 +112,36 @@ export function publicFunction(name, func, scopes = [Scope.preload, Scope.render
163
112
  *
164
113
  * @param name - name by which the variable will be accessed
165
114
  * @param value - variable getter/setter
166
- * @param scopes - variable scopes
167
115
  */
168
- export function publicVariable(name, value, scopes = [Scope.renderer, Scope.preload]) {
169
- mayThrowError();
170
- const { ipcMain } = electron;
171
- const { properties } = publicInfo;
172
- const getChannel = IPCChannel.propertyGet + name;
173
- const setChannel = IPCChannel.propertySet + name;
116
+ export function publicVariable(name, value) {
117
+ canThrowError();
118
+ const getChannel = IpcChannel.propertyGet + name;
119
+ const setChannel = IpcChannel.propertySet + name;
174
120
  const { get: getter, set: setter } = value;
175
- properties.add(name);
176
- if (!publicInfo.scopes.has(name)) {
177
- publicInfo.scopes.set(name, new Set(scopes));
178
- }
179
- if (!publicInfo.accesses.has(name)) {
180
- const accesses = [];
181
- getter && accesses.push(Access.get);
182
- setter && accesses.push(Access.set);
183
- publicInfo.accesses.set(name, new Set(accesses));
184
- }
185
- else {
186
- const accesses = publicInfo.accesses.get(name);
187
- getter && accesses.add(Access.get);
188
- setter && accesses.add(Access.set);
189
- }
121
+ entitiesInfo.variables.add(name);
190
122
  if (getter) {
191
123
  ipcMain.removeAllListeners(getChannel);
192
- ipcMain.on(getChannel, (event) => {
124
+ ipcMain.on(getChannel, e => {
125
+ const event = new MainEvent(e);
193
126
  try {
194
- const result = getter();
195
- event.returnValue = { value: result };
127
+ event.return(IpcResult.withValue(getter()));
196
128
  }
197
129
  catch (error) {
198
- event.returnValue = { error: String(error?.stack || error) };
130
+ event.return(IpcResult.withError(error));
199
131
  }
200
132
  });
201
133
  }
202
134
  if (setter) {
203
135
  ipcMain.removeAllListeners(setChannel);
204
- ipcMain.on(setChannel, (event, { args }) => {
136
+ ipcMain.on(setChannel, (e, { args }) => {
137
+ const event = new MainEvent(e);
205
138
  try {
206
139
  setter(args.at(0));
207
- event.returnValue = { value: null };
140
+ event.return(IpcResult.withValue(null));
208
141
  }
209
142
  catch (error) {
210
- event.returnValue = { error: String(error?.stack || error) };
143
+ event.return(IpcResult.withError(error));
211
144
  }
212
145
  });
213
146
  }
214
147
  }
215
- export function addScope(key, scope) {
216
- publicInfo.scopes.set(key, new Set([scope]));
217
- }
218
- export function addAccess(key, access) {
219
- publicInfo.accesses.set(key, new Set([access]));
220
- }
@@ -0,0 +1,6 @@
1
+ import type { IBridge } from '../../types.js';
2
+ /**
3
+ * Мост renderer-main.
4
+ */
5
+ declare const _default: IBridge;
6
+ export default _default;
@@ -0,0 +1,69 @@
1
+ import { GlobalProviderNotFoundError, NotProvidedFromMainError, WrongBridgeInPreloadError } from '../../errors.js';
2
+ import { Env, Errors } from '../helpers/index.js';
3
+ import BaseBridge from '../base-bridge.js';
4
+ /**
5
+ * Мост renderer-main.
6
+ */
7
+ class RendererBridge extends BaseBridge {
8
+ constructor() {
9
+ super();
10
+ if (!Env.hasProvider) {
11
+ throw new NotProvidedFromMainError();
12
+ }
13
+ this.globalProvider = window.__provider__;
14
+ this.entitiesInfo = this.globalProvider.getEntitiesInfo();
15
+ this.init();
16
+ }
17
+ callFunction(name, id, args) {
18
+ return this.globalProvider.entities.functions[name](id, args);
19
+ }
20
+ getVariable(name) {
21
+ return this.globalProvider.entities.variables[name].get();
22
+ }
23
+ setVariable(name, value) {
24
+ return this.globalProvider.entities.variables[name].set(value);
25
+ }
26
+ waitPromise(channel, id) {
27
+ return new Promise((resolve, reject) => {
28
+ this.globalProvider.waitPromise(channel, resolve, reject, id);
29
+ });
30
+ }
31
+ handleEvent(name, type, listener) {
32
+ return type === 'on'
33
+ ? this.globalProvider.entities.events.on(name, listener)
34
+ : this.globalProvider.entities.events.once(name, listener);
35
+ }
36
+ emitEvent(name, value) {
37
+ this.globalProvider.entities.events.emit(name, value);
38
+ }
39
+ }
40
+ /**
41
+ * Получить функцию, бросающую исключение, если есть повод.
42
+ */
43
+ function getErrorThrower() {
44
+ if (!Env.hasWindow) {
45
+ return Errors.getThrower(WrongBridgeInPreloadError);
46
+ }
47
+ if (!Env.hasProvider) {
48
+ return Errors.getThrower(GlobalProviderNotFoundError);
49
+ }
50
+ return null;
51
+ }
52
+ /**
53
+ * Получить мост renderer-main.
54
+ */
55
+ function getBridge() {
56
+ const throwError = getErrorThrower();
57
+ if (throwError) {
58
+ return new Proxy({}, {
59
+ get: throwError,
60
+ set: throwError,
61
+ apply: throwError
62
+ });
63
+ }
64
+ return new RendererBridge();
65
+ }
66
+ /**
67
+ * Мост renderer-main.
68
+ */
69
+ export default getBridge();
@@ -0,0 +1,171 @@
1
+ import type { IpcRendererEvent } from 'electron';
2
+ import type { EventListener, EventUnsubscribe, IRequest, IResult } from '../../types.js';
3
+ /**
4
+ * IPC туннель для функции.
5
+ */
6
+ declare class FunctionTunnel {
7
+ /**
8
+ * Туннель.
9
+ */
10
+ private readonly tunnel;
11
+ /**
12
+ * Создать IPC туннель для функции.
13
+ * @param name - Имя функции.
14
+ */
15
+ constructor(name: string);
16
+ /**
17
+ * Вызвать функцию.
18
+ * @param args - Аргументы вызова.
19
+ * @returns Результат вызова.
20
+ */
21
+ call(args?: IRequest): IResult;
22
+ }
23
+ /**
24
+ * Туннель для переменной.
25
+ */
26
+ declare class VariableTunnel {
27
+ /**
28
+ * Туннель для получения значения.
29
+ */
30
+ private readonly getTunnel;
31
+ /**
32
+ * Туннель для установки значения.
33
+ */
34
+ private readonly setTunnel;
35
+ /**
36
+ * Создать туннель для переменной.
37
+ * @param name - Имя переменной.
38
+ */
39
+ constructor(name: string);
40
+ /**
41
+ * Получить значение переменной.
42
+ */
43
+ get(): IResult;
44
+ /**
45
+ * Установить значение переменной.
46
+ * @param value - Значение.
47
+ */
48
+ set(value: any): IResult;
49
+ }
50
+ /**
51
+ * Туннель для обработки обещания.
52
+ */
53
+ declare class PromiseTunnel {
54
+ /**
55
+ * Туннель.
56
+ */
57
+ private readonly tunnel;
58
+ /**
59
+ * Создать туннель для обработки обещания.
60
+ * @param channel - Канал возвращающий обещание.
61
+ */
62
+ constructor(channel: string);
63
+ /**
64
+ * Ожидать завершения обещания.
65
+ * @param id - Уникальный идентификатор.
66
+ */
67
+ wait(id?: string): Promise<any>;
68
+ }
69
+ /**
70
+ * Туннель для события.
71
+ */
72
+ declare class EventTunnel {
73
+ private readonly name;
74
+ /**
75
+ * Туннель вызова события.
76
+ */
77
+ private readonly emitTunnel;
78
+ /**
79
+ * Туннель обработки события.
80
+ */
81
+ private readonly onTunnel;
82
+ /**
83
+ * Туннель однократной обработки события.
84
+ */
85
+ private readonly onceTunnel;
86
+ /**
87
+ * Создать туннель для события.
88
+ * @param name - Имя события.
89
+ */
90
+ constructor(name: string);
91
+ /**
92
+ * Добавить обработчик события.
93
+ * @param listener - Обработчик события.
94
+ * @returns Функция отписки от события.
95
+ */
96
+ on(listener: EventListener<IResult>): EventUnsubscribe;
97
+ /**
98
+ * Добавить одноразовый обработчик события.
99
+ * @param listener - Обработчик события.
100
+ * @returns Функция отписки от события.
101
+ */
102
+ once(listener: EventListener<IResult>): EventUnsubscribe;
103
+ /**
104
+ * Вызвать событие.
105
+ * @param value - Передаваемое значение.
106
+ */
107
+ emit(value: any): void;
108
+ /**
109
+ * Бросить ошибку.
110
+ * @param error - Ошибка.
111
+ */
112
+ error(error: Error | string): void;
113
+ }
114
+ /**
115
+ * IPC туннель.
116
+ */
117
+ export default class IPCTunnel {
118
+ private channel;
119
+ /**
120
+ * Туннель для функции.
121
+ */
122
+ static readonly Function: typeof FunctionTunnel;
123
+ /**
124
+ * Туннель для переменной.
125
+ */
126
+ static readonly Variable: typeof VariableTunnel;
127
+ /**
128
+ * Туннель для обещания.
129
+ */
130
+ static readonly Promise: typeof PromiseTunnel;
131
+ /**
132
+ * Туннель для события.
133
+ */
134
+ static readonly Event: typeof EventTunnel;
135
+ /**
136
+ * Создать IPC туннель.
137
+ * @param channel - Канал.
138
+ */
139
+ constructor(channel: string);
140
+ /**
141
+ * Отправить запрос.
142
+ * @param args - Аргументы запроса.
143
+ * @returns Результат запроса.
144
+ */
145
+ request(args?: IRequest): IResult;
146
+ /**
147
+ * Отправить ответ.
148
+ * @param result - Результат.
149
+ */
150
+ response(result?: IResult): void;
151
+ /**
152
+ * Добавить обработчик IPC.
153
+ * @param listener - Обработчик.
154
+ */
155
+ on(listener: (event: IpcRendererEvent, ...args: any[]) => void): void;
156
+ /**
157
+ * Добавить одноразовый обработчик IPC.
158
+ * @param listener - Обработчик.
159
+ */
160
+ once(listener: (event: IpcRendererEvent, ...args: any[]) => void): void;
161
+ /**
162
+ * Удалить обработчик IPC.
163
+ * @param listener - Обработчик.
164
+ */
165
+ removeListener(listener: (event: IpcRendererEvent, ...args: any[]) => void): void;
166
+ /**
167
+ * Удалить все обработчики IPC.
168
+ */
169
+ removeAllListeners(): void;
170
+ }
171
+ export {};