@one2x/medeo-plugin-sdk 0.0.0-stage → 0.11.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.
@@ -0,0 +1,203 @@
1
+ // Generated by platform-core from the capability registry; do not edit.
2
+ export const METHODS = {
3
+ "capabilities.list": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
4
+ "capabilities.labels": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
5
+ "providers.list": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
6
+ "permissions.request": { permission: null, provider: null, ui: true, confirm: true, adapter: "host" },
7
+ "i18n.state": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
8
+ "i18n.setLocale": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
9
+ "i18n.t": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
10
+ "i18n.catalog": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
11
+ "operations.state": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
12
+ "operations.list": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
13
+ "operations.cancel": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
14
+ "operations.release": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
15
+ "config.get": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
16
+ "config.set": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
17
+ "storage.get": { permission: "storage", provider: "medeo.storage", ui: false, confirm: false, adapter: "host" },
18
+ "storage.set": { permission: "storage", provider: "medeo.storage", ui: false, confirm: false, adapter: "host" },
19
+ "storage.remove": { permission: "storage", provider: "medeo.storage", ui: false, confirm: false, adapter: "host" },
20
+ "creation.open": { permission: "creation_open", provider: "medeo.creation", ui: false, confirm: false, adapter: "host" },
21
+ "resources.choose_directories": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: false, adapter: "host" },
22
+ "resources.request_directory": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: true, adapter: "host" },
23
+ "resources.list": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
24
+ "resources.revoke": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: false, adapter: "host" },
25
+ "files.roots": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
26
+ "files.mkdir": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
27
+ "files.history": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
28
+ "files.history_page": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
29
+ "files.backup_preview": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
30
+ "files.archive_backup": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: true, adapter: "host" },
31
+ "files.forget_preview": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
32
+ "files.forget_record": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: true, adapter: "host" },
33
+ "files.restore": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
34
+ "files.list": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
35
+ "files.stat": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
36
+ "files.read_text": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
37
+ "files.write_text": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
38
+ "files.move": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
39
+ "files.trash": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: true, adapter: "host" },
40
+ "files.trash_preview": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
41
+ "files.discard_preview": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
42
+ "files.watch": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
43
+ "files.events": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
44
+ "files.watches": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
45
+ "files.unwatch": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
46
+ "files.chooseFiles": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: false, adapter: "host" },
47
+ "files.import": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
48
+ "files.export": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: false, adapter: "host" },
49
+ "files.open": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: false, adapter: "electron" },
50
+ "files.reveal": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: false, adapter: "electron" },
51
+ "files.startDrag": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: false, adapter: "electron" },
52
+ "files.read_link": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
53
+ "files.measure": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
54
+ "files.list_tree": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
55
+ "files.trash_direct": { permission: "file_full_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
56
+ "network.request": { permission: "network", provider: "medeo.network", ui: false, confirm: false, adapter: "host" },
57
+ "network.read": { permission: "network", provider: "medeo.network", ui: false, confirm: false, adapter: "host" },
58
+ "network.origins": { permission: "network", provider: "medeo.network", ui: false, confirm: false, adapter: "host" },
59
+ "network.request_origin": { permission: "network", provider: "medeo.network", ui: true, confirm: true, adapter: "host" },
60
+ "network.revoke_origin": { permission: "network", provider: "medeo.network", ui: true, confirm: false, adapter: "host" },
61
+ "agent.models": { permission: "agent_api", provider: "medeo.agent", ui: false, confirm: false, adapter: "host" },
62
+ "agent.start": { permission: "agent_api", provider: "medeo.agent", ui: false, confirm: false, adapter: "host" },
63
+ "drive.state": { permission: "drive_read", provider: "medeo.drive", ui: false, confirm: false, adapter: "electron" },
64
+ "drive.folders": { permission: "drive_read", provider: "medeo.drive", ui: false, confirm: false, adapter: "electron" },
65
+ "drive.transfers": { permission: "drive_read", provider: "medeo.drive", ui: false, confirm: false, adapter: "electron" },
66
+ "drive.recent": { permission: "drive_read", provider: "medeo.drive", ui: false, confirm: false, adapter: "electron" },
67
+ "drive.failed": { permission: "drive_read", provider: "medeo.drive", ui: false, confirm: false, adapter: "electron" },
68
+ "drive.fileStates": { permission: "drive_read", provider: "medeo.drive", ui: false, confirm: false, adapter: "electron" },
69
+ "drive.requestFolder": { permission: "drive_read", provider: "medeo.drive", ui: true, confirm: true, adapter: "host" },
70
+ "drive.retry": { permission: "drive_manage", provider: "medeo.drive", ui: false, confirm: false, adapter: "electron" },
71
+ "drive.download": { permission: "drive_manage", provider: "medeo.drive", ui: false, confirm: false, adapter: "electron" },
72
+ "clipboard.read": { permission: "clipboard_read", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
73
+ "clipboard.write": { permission: "clipboard_write", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
74
+ "capture.status": { permission: "screen_capture", provider: "medeo.capture", ui: false, confirm: false, adapter: "host" },
75
+ "capture.sources": { permission: "screen_capture", provider: "medeo.capture", ui: true, confirm: false, adapter: "host" },
76
+ "capture.start": { permission: "screen_capture", provider: "medeo.capture", ui: true, confirm: true, adapter: "host" },
77
+ "capture.state": { permission: "screen_capture", provider: "medeo.capture", ui: false, confirm: false, adapter: "host" },
78
+ "capture.stop": { permission: "screen_capture", provider: "medeo.capture", ui: false, confirm: false, adapter: "host" },
79
+ "capture.cancel": { permission: "screen_capture", provider: "medeo.capture", ui: false, confirm: false, adapter: "host" },
80
+ "capture.open": { permission: "screen_capture", provider: "medeo.capture", ui: true, confirm: false, adapter: "electron" },
81
+ "capture.recover": { permission: "screen_capture", provider: "medeo.capture", ui: true, confirm: false, adapter: "host" },
82
+ "camera.status": { permission: "camera", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
83
+ "camera.start": { permission: "camera", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
84
+ "camera.stop": { permission: "camera", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
85
+ "camera.state": { permission: "camera", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
86
+ "camera.read": { permission: "camera", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
87
+ "microphone.status": { permission: "microphone", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
88
+ "microphone.start": { permission: "microphone", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
89
+ "microphone.stop": { permission: "microphone", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
90
+ "microphone.state": { permission: "microphone", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
91
+ "microphone.read": { permission: "microphone", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
92
+ "system_audio.status": { permission: "system_audio", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
93
+ "system_audio.start": { permission: "system_audio", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
94
+ "system_audio.stop": { permission: "system_audio", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
95
+ "system_audio.state": { permission: "system_audio", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
96
+ "system_audio.read": { permission: "system_audio", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
97
+ "applications.list": { permission: "applications", provider: "medeo.applications", ui: false, confirm: false, adapter: "host" },
98
+ "applications.launch": { permission: "applications", provider: "medeo.applications", ui: false, confirm: false, adapter: "host" },
99
+ "applications.state": { permission: "applications", provider: "medeo.applications", ui: false, confirm: false, adapter: "host" },
100
+ "applications.icons": { permission: "applications", provider: "medeo.applications", ui: false, confirm: false, adapter: "host" },
101
+ "plugins.commands": { permission: "plugin_commands", provider: "medeo.plugins", ui: false, confirm: false, adapter: "host" },
102
+ "plugins.run": { permission: "plugin_commands", provider: "medeo.plugins", ui: false, confirm: false, adapter: "electron" },
103
+ "plugins.open": { permission: "plugin_commands", provider: "medeo.plugins", ui: false, confirm: false, adapter: "electron" },
104
+ "plugins.center": { permission: "plugin_commands", provider: "medeo.plugins", ui: false, confirm: false, adapter: "electron" },
105
+ "plugins.suggestInstall": { permission: "plugin_commands", provider: "medeo.plugins", ui: true, confirm: false, adapter: "electron" },
106
+ "launcher.search": { permission: "plugin_commands", provider: "medeo.plugins", ui: false, confirm: false, adapter: "electron" },
107
+ "launcher.act": { permission: "plugin_commands", provider: "medeo.plugins", ui: false, confirm: false, adapter: "electron" },
108
+ "launcher.answer": { permission: "plugin_commands", provider: "medeo.plugins", ui: false, confirm: false, adapter: "electron" },
109
+ "launcher.events": { permission: "plugin_commands", provider: "medeo.plugins", ui: false, confirm: false, adapter: "electron" },
110
+ "shortcuts.register": { permission: "global_shortcuts", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
111
+ "shortcuts.unregister": { permission: "global_shortcuts", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
112
+ "shortcuts.events": { permission: "global_shortcuts", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
113
+ "shortcuts.list": { permission: "global_shortcuts", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
114
+ "notifications.show": { permission: "notifications", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
115
+ "notifications.close": { permission: "notifications", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
116
+ "tray.set": { permission: "tray", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
117
+ "tray.remove": { permission: "tray", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
118
+ "tray.events": { permission: "tray", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
119
+ "windows.open": { permission: "app_windows", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
120
+ "windows.close": { permission: "app_windows", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
121
+ "windows.focus": { permission: "app_windows", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
122
+ "windows.hide": { permission: "app_windows", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
123
+ "windows.list": { permission: "app_windows", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
124
+ "accessibility.status": { permission: "accessibility", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
125
+ "accessibility.request": { permission: "accessibility", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
126
+ "accessibility.windows": { permission: "accessibility", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
127
+ "accessibility.focus": { permission: "accessibility", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
128
+ "accessibility.selected_text": { permission: "accessibility", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
129
+ "accessibility.insert_text": { permission: "accessibility", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
130
+ "window_management.status": { permission: "window_management", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
131
+ "window_management.request": { permission: "window_management", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
132
+ "window_management.focused": { permission: "window_management", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
133
+ "window_management.set_frame": { permission: "window_management", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
134
+ "window_management.screens": { permission: "window_management", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
135
+ "window_management.pointer": { permission: "window_management", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
136
+ "input_method.status": { permission: "input_method", provider: "medeo.input-method", ui: false, confirm: false, adapter: "host" },
137
+ "input_method.configure": { permission: "input_method", provider: "medeo.input-method", ui: false, confirm: false, adapter: "host" },
138
+ "input_method.enable": { permission: "input_method", provider: "medeo.input-method", ui: true, confirm: false, adapter: "host" },
139
+ "input_method.disable": { permission: "input_method", provider: "medeo.input-method", ui: false, confirm: false, adapter: "host" },
140
+ "input_method.events": { permission: "input_method", provider: "medeo.input-method", ui: false, confirm: false, adapter: "host" },
141
+ "input_method.respond": { permission: "input_method", provider: "medeo.input-method", ui: false, confirm: false, adapter: "host" },
142
+ "input_method.system": { permission: "input_method", provider: "medeo.input-method", ui: false, confirm: false, adapter: "host" },
143
+ "input_method.setup": { permission: "input_method", provider: "medeo.input-method", ui: true, confirm: true, adapter: "host" },
144
+ "input_method.remove": { permission: "input_method", provider: "medeo.input-method", ui: true, confirm: true, adapter: "host" },
145
+ "input_method.settings": { permission: "input_method", provider: "medeo.input-method", ui: true, confirm: false, adapter: "host" },
146
+ "external.open": { permission: "external_open", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
147
+ "browser.open": { permission: "browser_view", provider: "medeo.desktop", ui: true, confirm: false, adapter: "electron" },
148
+ "browser.close": { permission: "browser_view", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
149
+ "browser.state": { permission: "browser_view", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
150
+ "system.info": { permission: "system_info", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
151
+ "system.running": { permission: "system_info", provider: "medeo.desktop", ui: false, confirm: false, adapter: "host" },
152
+ "secrets.get": { permission: "secrets", provider: "medeo.secrets", ui: false, confirm: false, adapter: "host" },
153
+ "secrets.set": { permission: "secrets", provider: "medeo.secrets", ui: false, confirm: false, adapter: "host" },
154
+ "secrets.remove": { permission: "secrets", provider: "medeo.secrets", ui: false, confirm: false, adapter: "host" },
155
+ "secrets.result": { permission: "secrets", provider: "medeo.secrets", ui: false, confirm: false, adapter: "host" },
156
+ "background.schedule": { permission: "background_tasks", provider: "medeo.background", ui: false, confirm: false, adapter: "host" },
157
+ "background.list": { permission: "background_tasks", provider: "medeo.background", ui: false, confirm: false, adapter: "host" },
158
+ "background.cancel": { permission: "background_tasks", provider: "medeo.background", ui: false, confirm: false, adapter: "host" },
159
+ "background.events": { permission: "background_tasks", provider: "medeo.background", ui: false, confirm: false, adapter: "host" },
160
+ "power.start": { permission: "power", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
161
+ "power.stop": { permission: "power", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
162
+ "power.state": { permission: "power", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
163
+ "process.start": { permission: "process_spawn", provider: "medeo.process", ui: false, confirm: false, adapter: "host" },
164
+ "process.state": { permission: "process_spawn", provider: "medeo.process", ui: false, confirm: false, adapter: "host" },
165
+ "process.write": { permission: "process_spawn", provider: "medeo.process", ui: false, confirm: false, adapter: "host" },
166
+ "process.stop": { permission: "process_spawn", provider: "medeo.process", ui: false, confirm: false, adapter: "host" },
167
+ "system.trash": { permission: "node", provider: "medeo.node", ui: false, confirm: false, adapter: "electron" },
168
+ "approvals.request": { permission: "approvals", provider: "medeo.approvals", ui: true, confirm: true, adapter: "host" },
169
+ "approvals.rules": { permission: "approvals", provider: "medeo.approvals", ui: false, confirm: false, adapter: "host" },
170
+ "approvals.forget": { permission: "approvals", provider: "medeo.approvals", ui: false, confirm: false, adapter: "host" },
171
+ "server.start": { permission: "local_server", provider: "medeo.local-server", ui: false, confirm: false, adapter: "host" },
172
+ "server.state": { permission: "local_server", provider: "medeo.local-server", ui: false, confirm: false, adapter: "host" },
173
+ "server.stop": { permission: "local_server", provider: "medeo.local-server", ui: false, confirm: false, adapter: "host" },
174
+ "server.events": { permission: "local_server", provider: "medeo.local-server", ui: false, confirm: false, adapter: "host" },
175
+ "server.respond": { permission: "local_server", provider: "medeo.local-server", ui: false, confirm: false, adapter: "host" },
176
+ "printing.print": { permission: "printing", provider: "medeo.desktop", ui: true, confirm: false, adapter: "electron" },
177
+ "contacts.status": { permission: "contacts", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
178
+ "contacts.request": { permission: "contacts", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
179
+ "contacts.list": { permission: "contacts", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
180
+ "contacts.save": { permission: "contacts", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
181
+ "calendar.status": { permission: "calendar", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
182
+ "calendar.request": { permission: "calendar", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
183
+ "calendar.list": { permission: "calendar", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
184
+ "calendar.save": { permission: "calendar", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
185
+ "location.status": { permission: "location", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
186
+ "location.request": { permission: "location", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
187
+ "location.current": { permission: "location", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
188
+ "devices.choose": { permission: "device_access", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
189
+ "devices.open": { permission: "device_access", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
190
+ "devices.read": { permission: "device_access", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
191
+ "devices.write": { permission: "device_access", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
192
+ "devices.close": { permission: "device_access", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
193
+ "devices.list": { permission: "device_access", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
194
+ };
195
+ export const LIMITS = {
196
+ notifications: 16,
197
+ power: 8,
198
+ shortcuts: 16,
199
+ windows: 8,
200
+ browser_windows: 4,
201
+ media_streams: 4,
202
+ queued_events: 64,
203
+ };
package/dist/rpc.d.ts ADDED
@@ -0,0 +1,28 @@
1
+ import { type Disposable } from './index.ts';
2
+ /** A transport is injectable for offline tests; the default is this plugin's own channel. */
3
+ export interface RpcTransport {
4
+ post(message: unknown): Promise<void>;
5
+ onMessage(listener: (message: unknown) => void): () => void;
6
+ }
7
+ export interface RpcOptions {
8
+ transport?: RpcTransport;
9
+ timeoutMs?: number;
10
+ signal?: AbortSignal;
11
+ }
12
+ type Handler = (...args: any[]) => unknown;
13
+ export type WorkerApiClient<T> = {
14
+ [K in keyof T]: T[K] extends (...args: infer A) => infer R ? (...args: A) => Promise<Awaited<R>> : never;
15
+ } & {
16
+ $dispose(): void;
17
+ };
18
+ /** Register in activate, then push the returned disposable into context.subscriptions.
19
+ * Requests only reach this plugin's worker; this is not a cross-plugin service API.
20
+ */
21
+ export declare function defineWorkerApi<T extends {
22
+ [K in keyof T]: Handler;
23
+ }>(handlers: T, options?: Pick<RpcOptions, 'transport'>): Disposable;
24
+ /** Create once per window, dispose on unmount. Timeout/disposal cancels waiting,
25
+ * not a worker side effect that already started. All arguments/results are JSON.
26
+ */
27
+ export declare function useWorkerApi<T>(options?: RpcOptions): WorkerApiClient<T>;
28
+ export {};
package/dist/rpc.js ADDED
@@ -0,0 +1,172 @@
1
+ import { channel } from "./index.js";
2
+ const PROTOCOL = 'medeo.rpc.v1';
3
+ const MAX_PENDING = 64;
4
+ const MAX_BYTES = 60 * 1024;
5
+ function packet(value) {
6
+ if (!value || typeof value !== 'object')
7
+ return false;
8
+ const p = value;
9
+ return p.protocol === PROTOCOL && ['request', 'result', 'error'].includes(p.kind) && typeof p.client === 'string' && p.client.length <= 80 && typeof p.id === 'string' && p.id.length <= 80;
10
+ }
11
+ /** Reject values JSON would silently drop or change, rather than corrupting an RPC argument. */
12
+ function checked(value) {
13
+ const seen = new Set();
14
+ function visit(v) {
15
+ if (v === null || typeof v === 'string' || typeof v === 'boolean')
16
+ return;
17
+ if (typeof v === 'number' && Number.isFinite(v))
18
+ return;
19
+ if (!v || typeof v !== 'object' || (!Array.isArray(v) && Object.getPrototypeOf(v) !== Object.prototype && Object.getPrototypeOf(v) !== null) || seen.has(v))
20
+ throw new Error('rpc_invalid_json');
21
+ seen.add(v);
22
+ const array = Array.isArray(v);
23
+ if (array && Object.keys(v).length !== v.length)
24
+ throw new Error('rpc_invalid_json');
25
+ for (const key of Reflect.ownKeys(v)) {
26
+ if (array && key === 'length')
27
+ continue;
28
+ const descriptor = Object.getOwnPropertyDescriptor(v, key);
29
+ if (typeof key !== 'string' || !descriptor.enumerable || !('value' in descriptor) ||
30
+ (array && (!/^(0|[1-9]\d*)$/.test(key) || Number(key) >= v.length)))
31
+ throw new Error('rpc_invalid_json');
32
+ visit(descriptor.value);
33
+ }
34
+ seen.delete(v);
35
+ }
36
+ visit(value);
37
+ const json = JSON.stringify(value);
38
+ if (new TextEncoder().encode(json).length > MAX_BYTES)
39
+ throw new Error('rpc_message_too_large');
40
+ return JSON.parse(json);
41
+ }
42
+ /** Register in activate, then push the returned disposable into context.subscriptions.
43
+ * Requests only reach this plugin's worker; this is not a cross-plugin service API.
44
+ */
45
+ export function defineWorkerApi(handlers, options = {}) {
46
+ for (const name of ['then', '$dispose']) {
47
+ if (Object.hasOwn(handlers, name))
48
+ throw new Error(`rpc_reserved_method: ${name}`);
49
+ }
50
+ const transport = options.transport ?? channel;
51
+ const active = new Set();
52
+ let stopped = false;
53
+ const respond = (p) => {
54
+ if (stopped)
55
+ return;
56
+ const message = checked(p);
57
+ void Promise.resolve().then(() => { if (!stopped)
58
+ return transport.post(message); }).catch(() => { });
59
+ };
60
+ const off = transport.onMessage(message => {
61
+ if (stopped || !packet(message) || message.kind !== 'request')
62
+ return;
63
+ const key = JSON.stringify([message.client, message.id]);
64
+ if (active.has(key))
65
+ return;
66
+ const reply = { protocol: PROTOCOL, client: message.client, id: message.id };
67
+ if (active.size >= MAX_PENDING) {
68
+ respond({ ...reply, kind: 'error', error: 'rpc_busy' });
69
+ return;
70
+ }
71
+ if (typeof message.method !== 'string' || !Object.hasOwn(handlers, message.method) || typeof handlers[message.method] !== 'function' || !Array.isArray(message.args)) {
72
+ respond({ ...reply, kind: 'error', error: 'rpc_method_not_found' });
73
+ return;
74
+ }
75
+ active.add(key);
76
+ void Promise.resolve().then(() => {
77
+ if (stopped)
78
+ return;
79
+ const request = checked(message);
80
+ return handlers[request.method](...request.args);
81
+ }).then(value => {
82
+ respond({ ...reply, kind: 'result', value: checked(value === undefined ? null : value) });
83
+ }).catch(error => {
84
+ let detail = 'rpc_failed';
85
+ try {
86
+ detail = String(error instanceof Error ? error.message : error).slice(0, 1000);
87
+ }
88
+ catch { }
89
+ respond({ ...reply, kind: 'error', error: detail });
90
+ }).finally(() => active.delete(key));
91
+ });
92
+ return { dispose() { stopped = true; off(); active.clear(); } };
93
+ }
94
+ /** Create once per window, dispose on unmount. Timeout/disposal cancels waiting,
95
+ * not a worker side effect that already started. All arguments/results are JSON.
96
+ */
97
+ export function useWorkerApi(options = {}) {
98
+ const transport = options.transport ?? channel;
99
+ const timeoutMs = options.timeoutMs ?? 30_000;
100
+ if (!Number.isFinite(timeoutMs) || timeoutMs <= 0 || timeoutMs > 300_000)
101
+ throw new Error('rpc_invalid_timeout');
102
+ const client = globalThis.crypto.randomUUID();
103
+ let sequence = 0, stopped = false;
104
+ const pending = new Map();
105
+ const settle = (id, value, error) => {
106
+ const request = pending.get(id);
107
+ if (!request)
108
+ return;
109
+ pending.delete(id);
110
+ clearTimeout(request.timer);
111
+ if (error !== undefined)
112
+ request.reject(new Error(error));
113
+ else
114
+ request.resolve(value);
115
+ };
116
+ const off = transport.onMessage(message => {
117
+ if (!packet(message) || message.client !== client || message.kind === 'request')
118
+ return;
119
+ try {
120
+ const response = checked(message);
121
+ if (response.kind === 'error')
122
+ settle(response.id, null, typeof response.error === 'string' ? response.error : 'rpc_failed');
123
+ else
124
+ settle(response.id, checked(response.value));
125
+ }
126
+ catch (error) {
127
+ settle(message.id, null, error instanceof Error ? error.message : 'rpc_invalid_json');
128
+ }
129
+ });
130
+ const dispose = () => {
131
+ if (stopped)
132
+ return;
133
+ stopped = true;
134
+ off();
135
+ options.signal?.removeEventListener('abort', dispose);
136
+ for (const id of pending.keys())
137
+ settle(id, null, 'rpc_disposed');
138
+ };
139
+ options.signal?.addEventListener('abort', dispose, { once: true });
140
+ if (options.signal?.aborted)
141
+ dispose();
142
+ return new Proxy(Object.create(null), {
143
+ get(_target, method) {
144
+ if (method === '$dispose')
145
+ return dispose;
146
+ if (method === 'then' || typeof method !== 'string')
147
+ return undefined;
148
+ return (...args) => {
149
+ if (stopped)
150
+ return Promise.reject(new Error('rpc_disposed'));
151
+ if (pending.size >= MAX_PENDING)
152
+ return Promise.reject(new Error('rpc_busy'));
153
+ const id = String(++sequence);
154
+ let message;
155
+ try {
156
+ message = checked({ protocol: PROTOCOL, kind: 'request', client, id, method, args });
157
+ }
158
+ catch (error) {
159
+ return Promise.reject(error);
160
+ }
161
+ return new Promise((resolve, reject) => {
162
+ const timer = setTimeout(() => settle(id, null, 'rpc_timeout'), timeoutMs);
163
+ pending.set(id, { resolve, reject, timer });
164
+ void Promise.resolve().then(() => {
165
+ if (!stopped && pending.has(id))
166
+ return transport.post(message);
167
+ }).catch(error => settle(id, null, error instanceof Error ? error.message : 'rpc_send_failed'));
168
+ });
169
+ };
170
+ },
171
+ });
172
+ }
@@ -0,0 +1,43 @@
1
+ import type { PluginAPI, PluginContext, PlatformEvent, PluginLocaleState } from './index.ts';
2
+ export type FakeHandler = (args: Record<string, unknown>) => unknown | Promise<unknown>;
3
+ type CommandHandler = Parameters<PluginContext['commands']['register']>[1];
4
+ export interface FakeHostOptions {
5
+ storage?: Record<string, unknown>;
6
+ /** Declared configuration keys and their initial/default values. */
7
+ config?: Record<string, unknown>;
8
+ handlers?: Record<string, FakeHandler>;
9
+ commands?: Record<string, CommandHandler>;
10
+ }
11
+ /** Offline bridge for real SDK calls. No OS, permissions, persistence or manifest
12
+ * validation is simulated. Channel messages loop back to this host's listeners.
13
+ * Install only within a serial test scope (globals cannot isolate concurrent tests).
14
+ * Every unimplemented capability fails unless supplied in `handlers`.
15
+ */
16
+ export declare function createFakeHost(options?: FakeHostOptions): {
17
+ api: PluginAPI;
18
+ context: PluginContext;
19
+ /** Explicit installation: importing this module never changes the global. */
20
+ install(): () => void;
21
+ emitEvent: (event: PlatformEvent) => void;
22
+ emitMessage: (message: unknown) => void;
23
+ emitLocaleChanged: (state: PluginLocaleState) => void;
24
+ /** What the plugin's `launcher.provide` answers, as a launcher would ask. */
25
+ launcherSearch(query: string, options?: {
26
+ scoped?: boolean;
27
+ limit?: number;
28
+ }): Promise<unknown>;
29
+ launcherAct(item: string, action: string, query?: string): Promise<unknown>;
30
+ /** Runs a command as a launcher does (with a session); its views are in `launcherViews`. */
31
+ runFromLauncher(command: string, args?: Record<string, unknown>, session?: string): Promise<unknown>;
32
+ launcherViews: {
33
+ session: string;
34
+ op: "update" | "prompt";
35
+ view: unknown;
36
+ }[];
37
+ /** How prompts are answered (default: confirmed). */
38
+ answerPrompts(answer: (view: unknown) => unknown): void;
39
+ dispose(): Promise<void>;
40
+ };
41
+ /** Installs a bridge for a callback and restores it even when the callback throws. */
42
+ export declare function withFakeHost<T>(options: FakeHostOptions, run: (host: ReturnType<typeof createFakeHost>) => T | Promise<T>): Promise<T>;
43
+ export {};