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
package/esm/helpers.js ADDED
@@ -0,0 +1,96 @@
1
+ import electron from 'electron';
2
+ export class WebContentsContainer {
3
+ container = {};
4
+ addOn(event, sender) {
5
+ this.addEvent(event);
6
+ this.container[event].on.push(sender);
7
+ }
8
+ addOnce(event, sender) {
9
+ this.addEvent(event);
10
+ this.container[event].once.push(sender);
11
+ }
12
+ getOn(event) {
13
+ return this.getEvent(event).on.filter(sender => !sender.isDestroyed());
14
+ }
15
+ getOnce(event) {
16
+ return this.getEvent(event).once.filter(sender => !sender.isDestroyed());
17
+ }
18
+ getAll(event) {
19
+ const senders = this.getEvent(event);
20
+ return [...senders.on, ...senders.once];
21
+ }
22
+ clearOnce(event) {
23
+ this.getEvent(event).once = [];
24
+ }
25
+ addEvent(name) {
26
+ this.container[name] ??= { on: [], once: [] };
27
+ }
28
+ getEvent(name) {
29
+ this.addEvent(name);
30
+ return this.container[name];
31
+ }
32
+ }
33
+ export class IpcResult {
34
+ static withPromise(promiseChannel) {
35
+ return { promiseChannel };
36
+ }
37
+ static withValue(value, id) {
38
+ return { value, id };
39
+ }
40
+ static withError(error, id) {
41
+ let resultError;
42
+ if (error === undefined) {
43
+ resultError = "Unknown error";
44
+ }
45
+ else if (typeof error === 'string') {
46
+ resultError = error;
47
+ }
48
+ else {
49
+ resultError = error.stack ?? error.message;
50
+ }
51
+ return { error: resultError, id };
52
+ }
53
+ }
54
+ export class MainEvent {
55
+ event;
56
+ constructor(event) {
57
+ this.event = event;
58
+ }
59
+ send(channel, result) {
60
+ this.event.sender.send(channel, result);
61
+ }
62
+ return(value) {
63
+ this.event.returnValue = value;
64
+ }
65
+ }
66
+ export class Id {
67
+ static generate() {
68
+ return Math.random().toString();
69
+ }
70
+ }
71
+ export class ErrorThrower {
72
+ static throws(errorClass, ...args) {
73
+ return () => { throw new errorClass(...args); };
74
+ }
75
+ }
76
+ export class Env {
77
+ static global = {
78
+ get hasWindow() {
79
+ return typeof window !== 'undefined';
80
+ },
81
+ get hasProvider() {
82
+ return Boolean(window.__provider__);
83
+ }
84
+ };
85
+ static electron = {
86
+ get hasIpcRenderer() {
87
+ return 'ipcRenderer' in electron;
88
+ },
89
+ get hasIpcMain() {
90
+ return 'ipcMain' in electron;
91
+ },
92
+ get hasContextBridge() {
93
+ return 'contextBridge' in electron;
94
+ }
95
+ };
96
+ }
package/esm/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/esm/index.js CHANGED
@@ -1,3 +1,3 @@
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';
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';
package/esm/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/esm/main.js CHANGED
@@ -1,3 +1 @@
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';
1
+ export { emitEvent, on, once, publicFunction, publicVariable } from './scripts/publish.js';
package/esm/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/esm/preload.js CHANGED
@@ -1,2 +1,2 @@
1
- export { default as Main } from './scripts/main';
2
- export { default as provideFromMain } from './scripts/preload-provider';
1
+ export { default as Bridge } from './scripts/preload-bridge.js';
2
+ export { default as provideFromMain } from './scripts/preload-provider.js';
package/esm/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/esm/renderer.js CHANGED
@@ -1 +1 @@
1
- export { default as Bridge } from './scripts/bridge';
1
+ export { default as Bridge } from './scripts/bridge.js';
@@ -0,0 +1,95 @@
1
+ import type { EventListener, EventUnsubscribe, IBridge, IEntitiesInfo, IHasSnapshot, IResult } from '../types.js';
2
+ /**
3
+ * Базовый класс моста до main.
4
+ */
5
+ export default abstract class BaseBridge implements IBridge {
6
+ /**
7
+ * Информация о сущностях.
8
+ */
9
+ protected abstract entitiesInfo: IEntitiesInfo;
10
+ /**
11
+ * Объект, который будет использоваться пользователем.
12
+ */
13
+ protected readonly target: {
14
+ as: () => any;
15
+ emit: (name: string, value: any) => void;
16
+ on: (name: string, listener: (() => void) | ((result: any) => void)) => EventUnsubscribe;
17
+ once: (name: string, listener: (() => void) | ((result: any) => void)) => EventUnsubscribe;
18
+ call: (func: any, Class: any, args: unknown[]) => any;
19
+ returns: (func: any, Class: any) => any;
20
+ };
21
+ as<TTarget>(): IBridge & TTarget;
22
+ emit(name: string, value: any): void;
23
+ on<TValue = any>(name: string, listener: EventListener<TValue>): EventUnsubscribe;
24
+ once<TValue = any>(name: string, listener: EventListener<TValue>): EventUnsubscribe;
25
+ call<TFunc extends (...args: any[]) => InstanceType<TClass>, TClass extends {
26
+ new (): IHasSnapshot;
27
+ }>(func: TFunc, Class: TClass, args: Parameters<TFunc>): InstanceType<TClass>;
28
+ returns<TFunc extends (...args: any[]) => InstanceType<TClass>, TClass extends {
29
+ new (): IHasSnapshot;
30
+ }>(func: TFunc, Class: TClass): TFunc;
31
+ /**
32
+ * Получить значение публичной переменной.
33
+ * @param name - Имя переменной.
34
+ */
35
+ protected abstract getVariable<TValue = unknown>(name: string): IResult<TValue>;
36
+ /**
37
+ * Установить значение публичной переменной.
38
+ * @param name - Имя переменной.
39
+ * @param value - Устанавливаемое значение.
40
+ */
41
+ protected abstract setVariable<TValue>(name: string, value: TValue): IResult<TValue>;
42
+ /**
43
+ * Вызвать публичную функцию.
44
+ * @param name - Имя функции.
45
+ * @param id - Уникальный идентификатор.
46
+ * @param args - Аргументы вызова.
47
+ */
48
+ protected abstract callFunction<TReturns = unknown>(name: string, id: string, args: any[]): IResult<TReturns>;
49
+ /**
50
+ * Ожидать завершения обещания.
51
+ * @param channel - Канал обработки обещания.
52
+ * @param id - Уникальный идентификатор.
53
+ */
54
+ protected abstract waitPromise<TReturns = unknown>(channel: string, id?: string): Promise<TReturns>;
55
+ /**
56
+ * Вызвать событие.
57
+ * @param name - Имя события.
58
+ * @param value - Передаваемое значение.
59
+ */
60
+ protected abstract emitEvent<TValue = unknown>(name: string, value?: TValue): void;
61
+ /**
62
+ * Добавить обработчик события.
63
+ * @param name - Имя события.
64
+ * @param type - Тип события.
65
+ * @param handler - Обработчик события.
66
+ * @returns Функция отписки от события.
67
+ */
68
+ protected abstract handleEvent<TValue = unknown>(name: string, type: 'on' | 'once', handler: EventListener<IResult<TValue>>): EventUnsubscribe;
69
+ /**
70
+ * Инициализация моста.
71
+ */
72
+ protected init(): void;
73
+ /**
74
+ * Обработать возможную ошибку.
75
+ *
76
+ * Бросает ошибку если она была передана.
77
+ * @param channel - IPC канал.
78
+ * @param error - Возможная ошибка (текст).
79
+ */
80
+ protected handlePossibleError(channel: string, error?: string): void | never;
81
+ /**
82
+ * Инициализировать доступ к публичным функциям.
83
+ */
84
+ protected initFunctions(): void;
85
+ /**
86
+ * Инициализировать доступ к публичным переменным.
87
+ */
88
+ protected initVariables(): void;
89
+ /**
90
+ * Добавить сущность в `target`.
91
+ * @param name - Имя.
92
+ * @param descriptor - Дескриптор значения.
93
+ */
94
+ protected define<TValue = unknown>(name: string, descriptor?: TypedPropertyDescriptor<TValue>): void;
95
+ }
@@ -0,0 +1,125 @@
1
+ import { NoGetAccessError, TrySetReadonlyError } from '../errors.js';
2
+ import { Errors, Id, Transfer } from './helpers/index.js';
3
+ /**
4
+ * Базовый класс моста до main.
5
+ */
6
+ export default class BaseBridge {
7
+ constructor() {
8
+ /**
9
+ * Объект, который будет использоваться пользователем.
10
+ */
11
+ this.target = {
12
+ as: () => this.as(),
13
+ emit: (...args) => this.emit(...args),
14
+ on: (...args) => this.on(...args),
15
+ once: (...args) => this.once(...args),
16
+ call: (...args) => this.call(...args),
17
+ returns: (...args) => this.returns(...args)
18
+ };
19
+ }
20
+ as() {
21
+ return this.target;
22
+ }
23
+ emit(name, value) {
24
+ this.emitEvent(name, Transfer.toTransferable(value));
25
+ }
26
+ on(name, listener) {
27
+ return this.handleEvent(name, 'on', ({ value, error }) => {
28
+ this.handlePossibleError(`event: ${name}`, error);
29
+ listener(value);
30
+ });
31
+ }
32
+ once(name, listener) {
33
+ return this.handleEvent(name, 'once', ({ value, error }) => {
34
+ this.handlePossibleError(`event: ${name}`, error);
35
+ listener(value);
36
+ });
37
+ }
38
+ call(func, Class, args) {
39
+ const value = func(...args);
40
+ if (Transfer.isSnapshotValue(value)) {
41
+ return Transfer.getFromSnapshot(value, Class);
42
+ }
43
+ return value;
44
+ }
45
+ returns(func, Class) {
46
+ return ((...args) => this.call(func, Class, args));
47
+ }
48
+ /**
49
+ * Инициализация моста.
50
+ */
51
+ init() {
52
+ this.initFunctions();
53
+ this.initVariables();
54
+ }
55
+ /**
56
+ * Обработать возможную ошибку.
57
+ *
58
+ * Бросает ошибку если она была передана.
59
+ * @param channel - IPC канал.
60
+ * @param error - Возможная ошибка (текст).
61
+ */
62
+ handlePossibleError(channel, error) {
63
+ if (!error) {
64
+ return;
65
+ }
66
+ throw new Error(`Error on ${channel}.\n${error}`.replace('Error: ', ''));
67
+ }
68
+ /**
69
+ * Инициализировать доступ к публичным функциям.
70
+ */
71
+ initFunctions() {
72
+ for (const name of this.entitiesInfo.functions) {
73
+ this.define(name, {
74
+ value: (...args) => {
75
+ const id = Id.new();
76
+ const preparedArgs = args.map(arg => Transfer.toTransferable(arg));
77
+ const { error, promiseChannel, value } = this.callFunction(name, id, preparedArgs);
78
+ this.handlePossibleError(name, error);
79
+ return promiseChannel
80
+ ? this.waitPromise(promiseChannel, id)
81
+ : value;
82
+ }
83
+ });
84
+ }
85
+ }
86
+ /**
87
+ * Инициализировать доступ к публичным переменным.
88
+ */
89
+ initVariables() {
90
+ for (const name of this.entitiesInfo.variables) {
91
+ this.define(name, {
92
+ get: () => {
93
+ const { error, value } = this.getVariable(name);
94
+ this.handlePossibleError(name, error);
95
+ return value;
96
+ },
97
+ set: (value) => {
98
+ const { error } = this.setVariable(name, value);
99
+ this.handlePossibleError(name, error);
100
+ }
101
+ });
102
+ }
103
+ }
104
+ /**
105
+ * Добавить сущность в `target`.
106
+ * @param name - Имя.
107
+ * @param descriptor - Дескриптор значения.
108
+ */
109
+ define(name, descriptor) {
110
+ const hasValue = Boolean(descriptor?.value);
111
+ const defaultDescriptor = {
112
+ get: () => descriptor.value,
113
+ set: Errors.getThrower(TrySetReadonlyError, name),
114
+ enumerable: true
115
+ };
116
+ const noValueDescriptor = {
117
+ get: descriptor?.get || Errors.getThrower(NoGetAccessError, name),
118
+ set: descriptor?.set || Errors.getThrower(TrySetReadonlyError, name),
119
+ enumerable: true
120
+ };
121
+ Object.defineProperty(this.target, name, hasValue
122
+ ? defaultDescriptor
123
+ : noValueDescriptor);
124
+ }
125
+ }
@@ -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;
@@ -1,52 +1,64 @@
1
- import { Scope } from '../enums';
2
- import { GlobalProviderNotFoundError, TryUseBridgeInPreload } from '../errors';
3
- import Provider from './provider';
4
- /**
5
- * Bridge between `renderer` and `main` processes.
6
- *
7
- * _only for renderer process_
8
- */
9
- let Bridge = new Proxy({ as: () => throwError() }, {
10
- get: () => throwError(),
11
- set: () => throwError(),
12
- apply: () => throwError()
13
- });
1
+ import { GlobalProviderNotFoundError, NotProvidedFromMain, TryUseBridgeInPreload } from '../errors.js';
2
+ import { Env, ErrorThrower } from './helpers/index.js';
3
+ import Provider from './provider.js';
14
4
  class ProviderIntoRenderer extends Provider {
15
- #globalProvider = window.__provider__;
16
- constructor() { super(); this.init(); }
17
- info = this.#globalProvider.getInfo();
18
- scope = Scope.renderer;
19
- callFunction(name, secret, args) {
20
- return this.#globalProvider.provided.functions[name](secret, args);
5
+ globalProvider;
6
+ entitiesInfo;
7
+ constructor() {
8
+ super();
9
+ if (!window.__provider__) {
10
+ throw new NotProvidedFromMain();
11
+ }
12
+ this.globalProvider = window.__provider__;
13
+ this.entitiesInfo = this.globalProvider.getEntitiesInfo();
14
+ this.init();
15
+ }
16
+ callFunction(name, id, args) {
17
+ return this.globalProvider.entities.functions[name](id, args);
21
18
  }
22
19
  getVariable(name) {
23
- return this.#globalProvider.provided.properties[name].get();
20
+ return this.globalProvider.entities.variables[name].get();
24
21
  }
25
22
  setVariable(name, value) {
26
- return this.#globalProvider.provided.properties[name].set(value);
23
+ return this.globalProvider.entities.variables[name].set(value);
27
24
  }
28
- waitPromise(channel, secret) {
25
+ waitPromise(channel, id) {
29
26
  return new Promise((resolve, reject) => {
30
- this.#globalProvider.waitPromise(channel, resolve, reject, secret);
27
+ this.globalProvider.waitPromise(channel, resolve, reject, id);
31
28
  });
32
29
  }
33
- handleMainEvent(name, type, handler) {
34
- return this.#globalProvider.provided.mainEvents[name](type, handler);
30
+ handleEvent(name, type, listener) {
31
+ return type === 'on'
32
+ ? this.globalProvider.entities.events.on(name, listener)
33
+ : this.globalProvider.entities.events.once(name, listener);
35
34
  }
36
- emitRendererEvent(name, arg) {
37
- this.#globalProvider.provided.rendererEvents[name](arg);
35
+ emitEvent(name, value) {
36
+ this.globalProvider.entities.events.emit(name, value);
38
37
  }
39
38
  }
40
- /** Выбрасывает ошибку если используется не в том процессе */
41
- let throwError;
42
- if (typeof window === 'undefined') {
43
- throwError = () => { throw new TryUseBridgeInPreload(); };
44
- }
45
- else if (!window.__provider__) {
46
- throwError = () => { throw new GlobalProviderNotFoundError(); };
39
+ function getErrorThrower() {
40
+ if (!Env.global.hasWindow) {
41
+ return ErrorThrower.throws(TryUseBridgeInPreload);
42
+ }
43
+ if (!Env.global.hasProvider) {
44
+ return ErrorThrower.throws(GlobalProviderNotFoundError);
45
+ }
46
+ return null;
47
47
  }
48
- else {
49
- // Выполняется только в web
50
- Bridge = new ProviderIntoRenderer();
48
+ function getBridge() {
49
+ const throwError = getErrorThrower();
50
+ if (throwError) {
51
+ return new Proxy({}, {
52
+ get: throwError,
53
+ set: throwError,
54
+ apply: throwError
55
+ });
56
+ }
57
+ return new ProviderIntoRenderer();
51
58
  }
52
- export default Bridge;
59
+ /**
60
+ * Bridge between `renderer` and `main` processes.
61
+ *
62
+ * _only for renderer process_
63
+ */
64
+ export default getBridge();
@@ -0,0 +1,4 @@
1
+ export default class ElectronImporter {
2
+ static getMain(): Promise<Partial<Awaited<typeof import('electron')>>>;
3
+ static getRenderer(): Promise<Partial<Awaited<typeof import('electron')>>>;
4
+ }
@@ -0,0 +1,16 @@
1
+ export default class ElectronImporter {
2
+ static getMain() {
3
+ return new Promise(resolve => {
4
+ import('electron')
5
+ .then(electron => resolve(electron))
6
+ .catch(() => resolve({}));
7
+ });
8
+ }
9
+ static getRenderer() {
10
+ return new Promise(resolve => {
11
+ import('electron')
12
+ .then(electron => resolve(electron))
13
+ .catch(() => resolve({}));
14
+ });
15
+ }
16
+ }
@@ -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,25 @@
1
+ /**
2
+ * Хелпер для работы с исполняемым окружением.
3
+ */
4
+ export default class Env {
5
+ /**
6
+ * Есть ли объект `window`.
7
+ */
8
+ static get hasWindow() {
9
+ return typeof window !== 'undefined';
10
+ }
11
+ /**
12
+ * Есть ли провайдер необходимых методов из `preload` в `renderer`. (`window.__provider__`)
13
+ */
14
+ static get hasProvider() {
15
+ return Boolean(window.__provider__);
16
+ }
17
+ /**
18
+ * Является ли окружение `preload` процессом.
19
+ *
20
+ * Работает корректно только если запущено в `preload` или `renderer`.
21
+ */
22
+ static get isPreload() {
23
+ return typeof global !== 'undefined';
24
+ }
25
+ }
@@ -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,5 @@
1
+ export default class ErrorThrower {
2
+ static throws(errorClass, ...args) {
3
+ return () => { throw new errorClass(...args); };
4
+ }
5
+ }
@@ -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,14 @@
1
+ /**
2
+ * Хелпер для работы с ошибками.
3
+ */
4
+ export default class Errors {
5
+ /**
6
+ * Получить функцию выброса ошибки.
7
+ * @param errorClass - Класс ошибки.
8
+ * @param args - Аргументы создания класса.
9
+ * @returns Функция выброса ошибки.
10
+ */
11
+ static getThrower(errorClass, ...args) {
12
+ return () => { throw new errorClass(...args); };
13
+ }
14
+ }
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Хелпер для работы с идентификаторами.
3
+ */
4
+ export default class Id {
5
+ /**
6
+ * Создать новый идентификатор.
7
+ */
8
+ static new(): string;
9
+ }
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Хелпер для работы с идентификаторами.
3
+ */
4
+ export default class Id {
5
+ /**
6
+ * Создать новый идентификатор.
7
+ */
8
+ static new() {
9
+ return Math.random().toString();
10
+ }
11
+ }
@@ -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,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';