emr-bridge 1.7.1 → 2.0.1
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.
- package/LICENCE +1 -1
- package/README.md +173 -366
- package/cjs/entries/index.d.ts +1 -0
- package/cjs/entries/index.js +6 -0
- package/cjs/entries/main.d.ts +2 -0
- package/cjs/entries/main.js +27 -0
- package/cjs/entries/preload.d.ts +3 -0
- package/cjs/entries/preload.js +29 -0
- package/cjs/entries/renderer.d.ts +2 -0
- package/cjs/entries/renderer.js +27 -0
- package/cjs/errors.d.ts +42 -10
- package/cjs/errors.js +77 -23
- package/cjs/scripts/base-bridge.d.ts +95 -0
- package/cjs/scripts/base-bridge.js +128 -0
- package/cjs/scripts/helpers/env.d.ts +19 -0
- package/cjs/scripts/helpers/env.js +28 -0
- package/cjs/scripts/helpers/errors.d.ts +12 -0
- package/cjs/scripts/helpers/errors.js +17 -0
- package/cjs/scripts/helpers/id.d.ts +9 -0
- package/cjs/scripts/helpers/id.js +14 -0
- package/cjs/scripts/helpers/index.d.ts +8 -0
- package/cjs/scripts/helpers/index.js +22 -0
- package/cjs/scripts/helpers/ipc-channel.d.ts +75 -0
- package/cjs/scripts/helpers/ipc-channel.js +78 -0
- package/cjs/scripts/helpers/ipc-event-in-main.d.ts +24 -0
- package/cjs/scripts/helpers/ipc-event-in-main.js +30 -0
- package/cjs/scripts/helpers/ipc-result.d.ts +26 -0
- package/cjs/scripts/helpers/ipc-result.js +48 -0
- package/cjs/scripts/helpers/transfer.d.ts +33 -0
- package/cjs/scripts/helpers/transfer.js +57 -0
- package/cjs/scripts/helpers/web-contents-events-container.d.ts +51 -0
- package/cjs/scripts/helpers/web-contents-events-container.js +75 -0
- package/cjs/scripts/main/publish.d.ts +36 -0
- package/cjs/scripts/main/publish.js +184 -0
- package/cjs/scripts/preload/bridge.d.ts +27 -0
- package/cjs/scripts/preload/bridge.js +85 -0
- package/cjs/scripts/preload/provider.d.ts +7 -0
- package/cjs/scripts/preload/provider.js +89 -0
- package/cjs/scripts/renderer/bridge.d.ts +6 -0
- package/cjs/scripts/renderer/bridge.js +74 -0
- package/cjs/scripts/renderer/tunnels.d.ts +171 -0
- package/cjs/scripts/renderer/tunnels.js +205 -0
- package/cjs/types.d.ts +189 -64
- package/esm/entries/index.d.ts +1 -0
- package/esm/entries/index.js +5 -0
- package/esm/entries/main.d.ts +2 -0
- package/esm/entries/main.js +5 -0
- package/esm/entries/preload.d.ts +3 -0
- package/esm/entries/preload.js +7 -0
- package/esm/entries/renderer.d.ts +2 -0
- package/esm/entries/renderer.js +6 -0
- package/esm/errors.d.ts +42 -10
- package/esm/errors.js +69 -16
- package/esm/scripts/base-bridge.d.ts +95 -0
- package/esm/scripts/base-bridge.js +125 -0
- package/esm/scripts/helpers/env.d.ts +19 -0
- package/esm/scripts/helpers/env.js +25 -0
- package/esm/scripts/helpers/errors.d.ts +12 -0
- package/esm/scripts/helpers/errors.js +14 -0
- package/esm/scripts/helpers/id.d.ts +9 -0
- package/esm/scripts/helpers/id.js +11 -0
- package/esm/scripts/helpers/index.d.ts +8 -0
- package/esm/scripts/helpers/index.js +8 -0
- package/esm/scripts/helpers/ipc-channel.d.ts +75 -0
- package/esm/scripts/helpers/ipc-channel.js +76 -0
- package/esm/scripts/helpers/ipc-event-in-main.d.ts +24 -0
- package/esm/scripts/helpers/ipc-event-in-main.js +27 -0
- package/esm/scripts/helpers/ipc-result.d.ts +26 -0
- package/esm/scripts/helpers/ipc-result.js +42 -0
- package/esm/scripts/helpers/transfer.d.ts +33 -0
- package/esm/scripts/helpers/transfer.js +54 -0
- package/esm/scripts/helpers/web-contents-events-container.d.ts +51 -0
- package/esm/scripts/helpers/web-contents-events-container.js +72 -0
- package/esm/scripts/main/publish.d.ts +36 -0
- package/esm/scripts/main/publish.js +177 -0
- package/esm/scripts/preload/bridge.d.ts +27 -0
- package/esm/scripts/preload/bridge.js +77 -0
- package/esm/scripts/preload/provider.d.ts +7 -0
- package/esm/scripts/preload/provider.js +84 -0
- package/esm/scripts/renderer/bridge.d.ts +6 -0
- package/esm/scripts/renderer/bridge.js +69 -0
- package/esm/scripts/renderer/tunnels.d.ts +171 -0
- package/esm/scripts/renderer/tunnels.js +203 -0
- package/esm/types.d.ts +189 -64
- package/package.json +23 -41
- package/cjs/enums.d.ts +0 -19
- package/cjs/enums.js +0 -25
- package/cjs/exp.d.ts +0 -4
- package/cjs/exp.js +0 -19
- package/cjs/index.d.ts +0 -4
- package/cjs/index.js +0 -18
- package/cjs/main.d.ts +0 -4
- package/cjs/main.js +0 -18
- package/cjs/preload.d.ts +0 -3
- package/cjs/preload.js +0 -10
- package/cjs/renderer.d.ts +0 -2
- package/cjs/renderer.js +0 -8
- package/cjs/scripts/bridge.d.ts +0 -8
- package/cjs/scripts/bridge.js +0 -57
- package/cjs/scripts/main.d.ts +0 -8
- package/cjs/scripts/main.js +0 -72
- package/cjs/scripts/new-decorators.d.ts +0 -150
- package/cjs/scripts/new-decorators.js +0 -141
- package/cjs/scripts/old-decorators.d.ts +0 -185
- package/cjs/scripts/old-decorators.js +0 -132
- package/cjs/scripts/preload-provider.d.ts +0 -7
- package/cjs/scripts/preload-provider.js +0 -96
- package/cjs/scripts/provider.d.ts +0 -25
- package/cjs/scripts/provider.js +0 -116
- package/cjs/scripts/publish.d.ts +0 -40
- package/cjs/scripts/publish.js +0 -232
- package/cjs/scripts/renderer-tunnels.d.ts +0 -47
- package/cjs/scripts/renderer-tunnels.js +0 -115
- package/esm/enums.d.ts +0 -19
- package/esm/enums.js +0 -22
- package/esm/exp.d.ts +0 -4
- package/esm/exp.js +0 -3
- package/esm/index.d.ts +0 -4
- package/esm/index.js +0 -3
- package/esm/main.d.ts +0 -4
- package/esm/main.js +0 -3
- package/esm/preload.d.ts +0 -3
- package/esm/preload.js +0 -2
- package/esm/renderer.d.ts +0 -2
- package/esm/renderer.js +0 -1
- package/esm/scripts/bridge.d.ts +0 -8
- package/esm/scripts/bridge.js +0 -52
- package/esm/scripts/main.d.ts +0 -8
- package/esm/scripts/main.js +0 -67
- package/esm/scripts/new-decorators.d.ts +0 -150
- package/esm/scripts/new-decorators.js +0 -132
- package/esm/scripts/old-decorators.d.ts +0 -185
- package/esm/scripts/old-decorators.js +0 -122
- package/esm/scripts/preload-provider.d.ts +0 -7
- package/esm/scripts/preload-provider.js +0 -91
- package/esm/scripts/provider.d.ts +0 -25
- package/esm/scripts/provider.js +0 -113
- package/esm/scripts/publish.d.ts +0 -40
- package/esm/scripts/publish.js +0 -220
- package/esm/scripts/renderer-tunnels.d.ts +0 -47
- package/esm/scripts/renderer-tunnels.js +0 -109
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
import { Scope } from '../enums.js';
|
|
2
|
-
import type { EventHandler, EventUnsubscriber, IPCResult, Info, Target } from '../types.js';
|
|
3
|
-
export default abstract class Provider implements Target {
|
|
4
|
-
protected abstract info: Info;
|
|
5
|
-
protected abstract scope: Scope;
|
|
6
|
-
protected abstract getVariable(name: string): IPCResult;
|
|
7
|
-
protected abstract setVariable(name: string, value: any): IPCResult;
|
|
8
|
-
protected abstract callFunction(name: string, secret: number, args: any[]): IPCResult;
|
|
9
|
-
protected abstract waitPromise(channel: string, secret?: number): Promise<any>;
|
|
10
|
-
protected abstract emitRendererEvent(name: string, arg: any): void;
|
|
11
|
-
protected abstract handleMainEvent(name: string, type: 'on' | 'once', handler: EventHandler<IPCResult>): EventUnsubscriber;
|
|
12
|
-
as<T>(): T;
|
|
13
|
-
protected readonly target: any;
|
|
14
|
-
protected init(): void;
|
|
15
|
-
protected errorHandler(error: string, channel: string): never;
|
|
16
|
-
protected initFunctions(): void;
|
|
17
|
-
protected initRendererEvents(): void;
|
|
18
|
-
protected initMainEvents(): void;
|
|
19
|
-
protected initProperties(): void;
|
|
20
|
-
protected define(name: string, attrs?: {
|
|
21
|
-
get?: () => any;
|
|
22
|
-
set?: (v: any) => void;
|
|
23
|
-
value?: any;
|
|
24
|
-
}): void;
|
|
25
|
-
}
|
package/esm/scripts/provider.js
DELETED
|
@@ -1,113 +0,0 @@
|
|
|
1
|
-
import { Access } from '../enums.js';
|
|
2
|
-
import { NoGetAccessError, NoSetAccessError, NotProvidedIntoScopeError, TrySetReadonlyError } from '../errors.js';
|
|
3
|
-
export default class Provider {
|
|
4
|
-
as() { return this.target; }
|
|
5
|
-
target = {};
|
|
6
|
-
init() {
|
|
7
|
-
this.initFunctions();
|
|
8
|
-
this.initProperties();
|
|
9
|
-
this.initMainEvents();
|
|
10
|
-
this.initRendererEvents();
|
|
11
|
-
}
|
|
12
|
-
errorHandler(error, channel) {
|
|
13
|
-
throw new Error(`Error on ${channel}.\n${error}`.replace('Error: ', ''));
|
|
14
|
-
}
|
|
15
|
-
initFunctions() {
|
|
16
|
-
for (const name of this.info.functions) {
|
|
17
|
-
this.define(name, {
|
|
18
|
-
value: (...args) => {
|
|
19
|
-
const secret = Math.random();
|
|
20
|
-
const { error, promiseChannel, value } = this.callFunction(name, secret, args);
|
|
21
|
-
if (error) {
|
|
22
|
-
this.errorHandler(error, name);
|
|
23
|
-
}
|
|
24
|
-
if (promiseChannel)
|
|
25
|
-
return this.waitPromise(promiseChannel, secret);
|
|
26
|
-
return value;
|
|
27
|
-
}
|
|
28
|
-
});
|
|
29
|
-
}
|
|
30
|
-
}
|
|
31
|
-
initRendererEvents() {
|
|
32
|
-
for (const name of this.info.rendererEvents) {
|
|
33
|
-
this.define(name, {
|
|
34
|
-
value: (arg) => {
|
|
35
|
-
this.emitRendererEvent(name, arg);
|
|
36
|
-
}
|
|
37
|
-
});
|
|
38
|
-
}
|
|
39
|
-
}
|
|
40
|
-
initMainEvents() {
|
|
41
|
-
for (const name of this.info.mainEvents) {
|
|
42
|
-
const eventNameOn = `on${name[0].toUpperCase()}${name.slice(1)}`;
|
|
43
|
-
const eventNameOnce = `once${name[0].toUpperCase()}${name.slice(1)}`;
|
|
44
|
-
this.define(eventNameOn, {
|
|
45
|
-
value: (handler) => {
|
|
46
|
-
return this.handleMainEvent(name, 'on', ({ error, value }) => {
|
|
47
|
-
if (error) {
|
|
48
|
-
this.errorHandler(error, name);
|
|
49
|
-
}
|
|
50
|
-
handler(value);
|
|
51
|
-
});
|
|
52
|
-
}
|
|
53
|
-
});
|
|
54
|
-
this.define(eventNameOnce, {
|
|
55
|
-
value: (handler) => {
|
|
56
|
-
return this.handleMainEvent(name, 'once', ({ error, value }) => {
|
|
57
|
-
if (error) {
|
|
58
|
-
this.errorHandler(error, name);
|
|
59
|
-
}
|
|
60
|
-
handler(value);
|
|
61
|
-
});
|
|
62
|
-
}
|
|
63
|
-
});
|
|
64
|
-
}
|
|
65
|
-
}
|
|
66
|
-
initProperties() {
|
|
67
|
-
for (const name of this.info.properties) {
|
|
68
|
-
this.define(name, {
|
|
69
|
-
get: this.info.accesses.get(name).has(Access.get)
|
|
70
|
-
? () => {
|
|
71
|
-
const { error, value } = this.getVariable(name);
|
|
72
|
-
if (error) {
|
|
73
|
-
this.errorHandler(error, name);
|
|
74
|
-
}
|
|
75
|
-
return value;
|
|
76
|
-
}
|
|
77
|
-
: () => { throw new NoGetAccessError(name); },
|
|
78
|
-
set: this.info.accesses.get(name).has(Access.set)
|
|
79
|
-
? (value) => {
|
|
80
|
-
const { error } = this.setVariable(name, value);
|
|
81
|
-
if (error) {
|
|
82
|
-
this.errorHandler(error, name);
|
|
83
|
-
}
|
|
84
|
-
}
|
|
85
|
-
: () => { throw new NoSetAccessError(name); }
|
|
86
|
-
});
|
|
87
|
-
}
|
|
88
|
-
}
|
|
89
|
-
define(name, attrs) {
|
|
90
|
-
let descriptor;
|
|
91
|
-
if (!this.info.scopes.get(name).has(this.scope)) {
|
|
92
|
-
descriptor = {
|
|
93
|
-
get: () => { throw new NotProvidedIntoScopeError(name, this.scope); },
|
|
94
|
-
set: () => { throw new NotProvidedIntoScopeError(name, this.scope); }
|
|
95
|
-
};
|
|
96
|
-
}
|
|
97
|
-
else if (attrs?.value) {
|
|
98
|
-
descriptor = {
|
|
99
|
-
get: () => attrs.value,
|
|
100
|
-
set: () => { throw new TrySetReadonlyError(name); },
|
|
101
|
-
enumerable: true
|
|
102
|
-
};
|
|
103
|
-
}
|
|
104
|
-
else {
|
|
105
|
-
descriptor = {
|
|
106
|
-
get: attrs?.get || (() => { throw new NoSetAccessError(name); }),
|
|
107
|
-
set: attrs?.set || (() => { throw new TrySetReadonlyError(name); }),
|
|
108
|
-
enumerable: true
|
|
109
|
-
};
|
|
110
|
-
}
|
|
111
|
-
Object.defineProperty(this.target, name, descriptor);
|
|
112
|
-
}
|
|
113
|
-
}
|
package/esm/scripts/publish.d.ts
DELETED
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
import { Access, Scope } from '../enums.js';
|
|
2
|
-
import type { PublicFunction, PublicProperty, RendererEvent } from '../types.js';
|
|
3
|
-
/**
|
|
4
|
-
* Makes the event from **main** available for **renderer** and **preload** processes.
|
|
5
|
-
*
|
|
6
|
-
* @param name - name by which the event will be accessed
|
|
7
|
-
* @param procFn - function of processing before sending the event
|
|
8
|
-
* @param scopes - event scopes
|
|
9
|
-
*/
|
|
10
|
-
export declare function publicMainEvent<In = void, Out = In extends Array<any> ? In[0] : In, ProcFn extends (...args: any[]) => any = In extends Array<any> ? (...args: In) => Out : (val: In) => Out>(name: string, procFn?: ProcFn, scopes?: Scope[]): (...args: Parameters<ProcFn>) => void;
|
|
11
|
-
/**
|
|
12
|
-
* Makes the event from **renderer** and **preload** available for **main** process.
|
|
13
|
-
*
|
|
14
|
-
* @param name - name by which the event will be accessed
|
|
15
|
-
* @param procFn - processing function before calling handlers
|
|
16
|
-
* @param scopes - event scopes
|
|
17
|
-
*/
|
|
18
|
-
export declare function publicRendererEvent<In = void, Out = In, ProcFn extends (...args: any[]) => any = (v?: In) => Out>(name: string, procFn?: ProcFn, scopes?: Scope[]): RendererEvent<Out>;
|
|
19
|
-
/**
|
|
20
|
-
* Makes the function available for **renderer** and **preload** processes.
|
|
21
|
-
*
|
|
22
|
-
* _only for function_
|
|
23
|
-
*
|
|
24
|
-
* @param name - name by which the function will be accessed
|
|
25
|
-
* @param func - linked function
|
|
26
|
-
* @param scopes - function scopes
|
|
27
|
-
*/
|
|
28
|
-
export declare function publicFunction<F extends PublicFunction>(name: string, func: F, scopes?: Scope[]): void;
|
|
29
|
-
/**
|
|
30
|
-
* Makes the function available for **renderer** and **preload** processes.
|
|
31
|
-
*
|
|
32
|
-
* _only for variables_
|
|
33
|
-
*
|
|
34
|
-
* @param name - name by which the variable will be accessed
|
|
35
|
-
* @param value - variable getter/setter
|
|
36
|
-
* @param scopes - variable scopes
|
|
37
|
-
*/
|
|
38
|
-
export declare function publicVariable<T>(name: string, value: PublicProperty<T>, scopes?: Scope[]): void;
|
|
39
|
-
export declare function addScope(key: string, scope: Scope): void;
|
|
40
|
-
export declare function addAccess(key: string, access: Access): void;
|
package/esm/scripts/publish.js
DELETED
|
@@ -1,220 +0,0 @@
|
|
|
1
|
-
import electron from 'electron';
|
|
2
|
-
import { Access, IPCChannel, Scope } from '../enums.js';
|
|
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()
|
|
10
|
-
};
|
|
11
|
-
/** Выбрасывает ошибку если используется не в том процессе */
|
|
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
|
-
}
|
|
19
|
-
/**
|
|
20
|
-
* Makes the event from **main** available for **renderer** and **preload** processes.
|
|
21
|
-
*
|
|
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
|
|
25
|
-
*/
|
|
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());
|
|
50
|
-
}
|
|
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
|
-
};
|
|
78
|
-
}
|
|
79
|
-
/**
|
|
80
|
-
* Makes the event from **renderer** and **preload** available for **main** process.
|
|
81
|
-
*
|
|
82
|
-
* @param name - name by which the event will be accessed
|
|
83
|
-
* @param procFn - processing function before calling handlers
|
|
84
|
-
* @param scopes - event scopes
|
|
85
|
-
*/
|
|
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
|
-
};
|
|
120
|
-
}
|
|
121
|
-
/**
|
|
122
|
-
* Makes the function available for **renderer** and **preload** processes.
|
|
123
|
-
*
|
|
124
|
-
* _only for function_
|
|
125
|
-
*
|
|
126
|
-
* @param name - name by which the function will be accessed
|
|
127
|
-
* @param func - linked function
|
|
128
|
-
* @param scopes - function scopes
|
|
129
|
-
*/
|
|
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
|
-
}
|
|
139
|
-
ipcMain.removeAllListeners(channel);
|
|
140
|
-
ipcMain.on(channel, (e, { args, secret }) => {
|
|
141
|
-
try {
|
|
142
|
-
const result = func(...args);
|
|
143
|
-
if (result instanceof Promise) {
|
|
144
|
-
const promiseChannel = channel + IPCChannel.promisePostfix;
|
|
145
|
-
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 };
|
|
149
|
-
}
|
|
150
|
-
else {
|
|
151
|
-
e.returnValue = { value: result };
|
|
152
|
-
}
|
|
153
|
-
}
|
|
154
|
-
catch (error) {
|
|
155
|
-
e.returnValue = { error: String(error?.stack || error) };
|
|
156
|
-
}
|
|
157
|
-
});
|
|
158
|
-
}
|
|
159
|
-
/**
|
|
160
|
-
* Makes the function available for **renderer** and **preload** processes.
|
|
161
|
-
*
|
|
162
|
-
* _only for variables_
|
|
163
|
-
*
|
|
164
|
-
* @param name - name by which the variable will be accessed
|
|
165
|
-
* @param value - variable getter/setter
|
|
166
|
-
* @param scopes - variable scopes
|
|
167
|
-
*/
|
|
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;
|
|
174
|
-
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
|
-
}
|
|
190
|
-
if (getter) {
|
|
191
|
-
ipcMain.removeAllListeners(getChannel);
|
|
192
|
-
ipcMain.on(getChannel, (event) => {
|
|
193
|
-
try {
|
|
194
|
-
const result = getter();
|
|
195
|
-
event.returnValue = { value: result };
|
|
196
|
-
}
|
|
197
|
-
catch (error) {
|
|
198
|
-
event.returnValue = { error: String(error?.stack || error) };
|
|
199
|
-
}
|
|
200
|
-
});
|
|
201
|
-
}
|
|
202
|
-
if (setter) {
|
|
203
|
-
ipcMain.removeAllListeners(setChannel);
|
|
204
|
-
ipcMain.on(setChannel, (event, { args }) => {
|
|
205
|
-
try {
|
|
206
|
-
setter(args.at(0));
|
|
207
|
-
event.returnValue = { value: null };
|
|
208
|
-
}
|
|
209
|
-
catch (error) {
|
|
210
|
-
event.returnValue = { error: String(error?.stack || error) };
|
|
211
|
-
}
|
|
212
|
-
});
|
|
213
|
-
}
|
|
214
|
-
}
|
|
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
|
-
}
|
|
@@ -1,47 +0,0 @@
|
|
|
1
|
-
import type { IpcRendererEvent } from 'electron';
|
|
2
|
-
import type { EventHandler, EventUnsubscriber, IPCRequest, IPCResult } from '../types.js';
|
|
3
|
-
declare class FunctionTunnel {
|
|
4
|
-
#private;
|
|
5
|
-
constructor(name: string);
|
|
6
|
-
call(args?: IPCRequest): IPCResult;
|
|
7
|
-
}
|
|
8
|
-
declare class PropertyTunnel {
|
|
9
|
-
#private;
|
|
10
|
-
constructor(name: string);
|
|
11
|
-
get(): IPCResult;
|
|
12
|
-
set(value: any): IPCResult;
|
|
13
|
-
}
|
|
14
|
-
declare class PromiseTunnel {
|
|
15
|
-
#private;
|
|
16
|
-
constructor(channel: string);
|
|
17
|
-
wait(secret?: number): Promise<any>;
|
|
18
|
-
}
|
|
19
|
-
declare class MainEventTunnel {
|
|
20
|
-
#private;
|
|
21
|
-
constructor(name: string);
|
|
22
|
-
on(handler: EventHandler<IPCResult>): EventUnsubscriber;
|
|
23
|
-
once(handler: EventHandler<IPCResult>): EventUnsubscriber;
|
|
24
|
-
}
|
|
25
|
-
declare class RendererEventTunnel {
|
|
26
|
-
#private;
|
|
27
|
-
constructor(name: string);
|
|
28
|
-
emit(value: any): void;
|
|
29
|
-
error(error: string): void;
|
|
30
|
-
}
|
|
31
|
-
export default class IPCTunnel {
|
|
32
|
-
#private;
|
|
33
|
-
private channel;
|
|
34
|
-
static readonly Function: typeof FunctionTunnel;
|
|
35
|
-
static readonly Property: typeof PropertyTunnel;
|
|
36
|
-
static readonly Promise: typeof PromiseTunnel;
|
|
37
|
-
static readonly MainEvent: typeof MainEventTunnel;
|
|
38
|
-
static readonly RendererEvent: typeof RendererEventTunnel;
|
|
39
|
-
constructor(channel: string);
|
|
40
|
-
request(args?: IPCRequest): IPCResult;
|
|
41
|
-
response(args?: IPCResult): void;
|
|
42
|
-
on(listener: (event: IpcRendererEvent, ...args: any[]) => void): void;
|
|
43
|
-
once(listener: (event: IpcRendererEvent, ...args: any[]) => void): void;
|
|
44
|
-
removeListener(listener: (event: IpcRendererEvent, ...args: any[]) => void): void;
|
|
45
|
-
removeAllListeners(): void;
|
|
46
|
-
}
|
|
47
|
-
export {};
|
|
@@ -1,109 +0,0 @@
|
|
|
1
|
-
import electron from 'electron';
|
|
2
|
-
import { IPCChannel } from '../enums.js';
|
|
3
|
-
class FunctionTunnel {
|
|
4
|
-
#tunnel;
|
|
5
|
-
constructor(name) {
|
|
6
|
-
this.#tunnel = new IPCTunnel(IPCChannel.functionCall + name);
|
|
7
|
-
}
|
|
8
|
-
call(args = { args: [] }) {
|
|
9
|
-
return this.#tunnel.request(args);
|
|
10
|
-
}
|
|
11
|
-
}
|
|
12
|
-
class PropertyTunnel {
|
|
13
|
-
#getTunnel;
|
|
14
|
-
#setTunnel;
|
|
15
|
-
constructor(name) {
|
|
16
|
-
this.#getTunnel = new IPCTunnel(IPCChannel.propertyGet + name);
|
|
17
|
-
this.#setTunnel = new IPCTunnel(IPCChannel.propertySet + name);
|
|
18
|
-
}
|
|
19
|
-
get() {
|
|
20
|
-
return this.#getTunnel.request();
|
|
21
|
-
}
|
|
22
|
-
set(value) {
|
|
23
|
-
return this.#setTunnel.request({ args: [value] });
|
|
24
|
-
}
|
|
25
|
-
}
|
|
26
|
-
class PromiseTunnel {
|
|
27
|
-
#tunnel;
|
|
28
|
-
constructor(channel) {
|
|
29
|
-
this.#tunnel = new IPCTunnel(channel);
|
|
30
|
-
}
|
|
31
|
-
wait(secret) {
|
|
32
|
-
return new Promise((resolve, reject) => {
|
|
33
|
-
const handler = (_, { error, value, secret: resSecret }) => {
|
|
34
|
-
if (secret !== undefined && resSecret !== secret)
|
|
35
|
-
return;
|
|
36
|
-
if (error)
|
|
37
|
-
reject(error);
|
|
38
|
-
else
|
|
39
|
-
resolve(value);
|
|
40
|
-
this.#tunnel.removeListener(handler);
|
|
41
|
-
};
|
|
42
|
-
this.#tunnel.on(handler);
|
|
43
|
-
});
|
|
44
|
-
}
|
|
45
|
-
}
|
|
46
|
-
class MainEventTunnel {
|
|
47
|
-
#emitTunnel;
|
|
48
|
-
#onTunnel;
|
|
49
|
-
#onceTunnel;
|
|
50
|
-
constructor(name) {
|
|
51
|
-
this.#emitTunnel = new IPCTunnel(IPCChannel.mainEventEmit + name);
|
|
52
|
-
this.#onTunnel = new IPCTunnel(IPCChannel.mainEventOn + name);
|
|
53
|
-
this.#onceTunnel = new IPCTunnel(IPCChannel.mainEventOnce + name);
|
|
54
|
-
}
|
|
55
|
-
on(handler) {
|
|
56
|
-
const listener = (_, result) => handler(result);
|
|
57
|
-
this.#onTunnel.response();
|
|
58
|
-
this.#emitTunnel.on(listener);
|
|
59
|
-
return () => this.#emitTunnel.removeListener(listener);
|
|
60
|
-
}
|
|
61
|
-
once(handler) {
|
|
62
|
-
const listener = (_, result) => handler(result);
|
|
63
|
-
this.#onceTunnel.response();
|
|
64
|
-
this.#emitTunnel.once(listener);
|
|
65
|
-
return () => this.#emitTunnel.removeListener(listener);
|
|
66
|
-
}
|
|
67
|
-
}
|
|
68
|
-
class RendererEventTunnel {
|
|
69
|
-
#emitTunnel;
|
|
70
|
-
constructor(name) {
|
|
71
|
-
this.#emitTunnel = new IPCTunnel(IPCChannel.rendererEventEmit + name);
|
|
72
|
-
}
|
|
73
|
-
emit(value) {
|
|
74
|
-
this.#emitTunnel.response({ value });
|
|
75
|
-
}
|
|
76
|
-
error(error) {
|
|
77
|
-
this.#emitTunnel.response({ error });
|
|
78
|
-
}
|
|
79
|
-
}
|
|
80
|
-
export default class IPCTunnel {
|
|
81
|
-
channel;
|
|
82
|
-
#ipcRenderer = electron.ipcRenderer;
|
|
83
|
-
static Function = FunctionTunnel;
|
|
84
|
-
static Property = PropertyTunnel;
|
|
85
|
-
static Promise = PromiseTunnel;
|
|
86
|
-
static MainEvent = MainEventTunnel;
|
|
87
|
-
static RendererEvent = RendererEventTunnel;
|
|
88
|
-
constructor(channel) {
|
|
89
|
-
this.channel = channel;
|
|
90
|
-
}
|
|
91
|
-
request(args = { args: [] }) {
|
|
92
|
-
return this.#ipcRenderer.sendSync(this.channel, args);
|
|
93
|
-
}
|
|
94
|
-
response(args = {}) {
|
|
95
|
-
this.#ipcRenderer.send(this.channel, args);
|
|
96
|
-
}
|
|
97
|
-
on(listener) {
|
|
98
|
-
this.#ipcRenderer.on(this.channel, listener);
|
|
99
|
-
}
|
|
100
|
-
once(listener) {
|
|
101
|
-
this.#ipcRenderer.once(this.channel, listener);
|
|
102
|
-
}
|
|
103
|
-
removeListener(listener) {
|
|
104
|
-
this.#ipcRenderer.removeListener(this.channel, listener);
|
|
105
|
-
}
|
|
106
|
-
removeAllListeners() {
|
|
107
|
-
this.#ipcRenderer.removeAllListeners(this.channel);
|
|
108
|
-
}
|
|
109
|
-
}
|