@krate/app 0.0.0-stage → 0.5.0-rc.7

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 (132) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +88 -2
  3. package/dist/automation.d.ts +11 -0
  4. package/dist/automation.d.ts.map +1 -0
  5. package/dist/automation.js +27 -0
  6. package/dist/badge.d.ts +13 -0
  7. package/dist/badge.d.ts.map +1 -0
  8. package/dist/badge.js +34 -0
  9. package/dist/chrome.d.ts +90 -0
  10. package/dist/chrome.d.ts.map +1 -0
  11. package/dist/chrome.js +133 -0
  12. package/dist/client.d.ts +26 -0
  13. package/dist/client.d.ts.map +1 -0
  14. package/dist/client.js +545 -0
  15. package/dist/clipboard.d.ts +19 -0
  16. package/dist/clipboard.d.ts.map +1 -0
  17. package/dist/clipboard.js +51 -0
  18. package/dist/cookies.d.ts +44 -0
  19. package/dist/cookies.d.ts.map +1 -0
  20. package/dist/cookies.js +45 -0
  21. package/dist/crash.d.ts +35 -0
  22. package/dist/crash.d.ts.map +1 -0
  23. package/dist/crash.js +28 -0
  24. package/dist/db.d.ts +14 -0
  25. package/dist/db.d.ts.map +1 -0
  26. package/dist/db.js +23 -0
  27. package/dist/dialog.d.ts +36 -0
  28. package/dist/dialog.d.ts.map +1 -0
  29. package/dist/dialog.js +23 -0
  30. package/dist/downloads.d.ts +35 -0
  31. package/dist/downloads.d.ts.map +1 -0
  32. package/dist/downloads.js +30 -0
  33. package/dist/driver.d.ts +190 -0
  34. package/dist/driver.d.ts.map +1 -0
  35. package/dist/driver.js +637 -0
  36. package/dist/errors.d.ts +7 -0
  37. package/dist/errors.d.ts.map +1 -0
  38. package/dist/errors.js +11 -0
  39. package/dist/events.d.ts +6 -0
  40. package/dist/events.d.ts.map +1 -0
  41. package/dist/events.js +47 -0
  42. package/dist/extension.d.ts +10 -0
  43. package/dist/extension.d.ts.map +1 -0
  44. package/dist/extension.js +25 -0
  45. package/dist/fakehost.d.ts +18 -0
  46. package/dist/fakehost.d.ts.map +1 -0
  47. package/dist/fakehost.js +199 -0
  48. package/dist/fs.d.ts +26 -0
  49. package/dist/fs.d.ts.map +1 -0
  50. package/dist/fs.js +38 -0
  51. package/dist/host.d.ts +4 -0
  52. package/dist/host.d.ts.map +1 -0
  53. package/dist/host.js +25 -0
  54. package/dist/index.d.ts +19 -0
  55. package/dist/index.d.ts.map +1 -0
  56. package/dist/index.js +40 -0
  57. package/dist/kv.d.ts +6 -0
  58. package/dist/kv.d.ts.map +1 -0
  59. package/dist/kv.js +19 -0
  60. package/dist/lifecycle.d.ts +22 -0
  61. package/dist/lifecycle.d.ts.map +1 -0
  62. package/dist/lifecycle.js +85 -0
  63. package/dist/login.d.ts +10 -0
  64. package/dist/login.d.ts.map +1 -0
  65. package/dist/login.js +8 -0
  66. package/dist/media.d.ts +50 -0
  67. package/dist/media.d.ts.map +1 -0
  68. package/dist/media.js +70 -0
  69. package/dist/menu.d.ts +71 -0
  70. package/dist/menu.d.ts.map +1 -0
  71. package/dist/menu.js +114 -0
  72. package/dist/mock.d.ts +14 -0
  73. package/dist/mock.d.ts.map +1 -0
  74. package/dist/mock.js +47 -0
  75. package/dist/notify.d.ts +25 -0
  76. package/dist/notify.d.ts.map +1 -0
  77. package/dist/notify.js +32 -0
  78. package/dist/offscreen.d.ts +24 -0
  79. package/dist/offscreen.d.ts.map +1 -0
  80. package/dist/offscreen.js +27 -0
  81. package/dist/os.d.ts +20 -0
  82. package/dist/os.d.ts.map +1 -0
  83. package/dist/os.js +43 -0
  84. package/dist/page.d.ts +69 -0
  85. package/dist/page.d.ts.map +1 -0
  86. package/dist/page.js +61 -0
  87. package/dist/permission.d.ts +5 -0
  88. package/dist/permission.d.ts.map +1 -0
  89. package/dist/permission.js +18 -0
  90. package/dist/port.d.ts +35 -0
  91. package/dist/port.d.ts.map +1 -0
  92. package/dist/port.js +159 -0
  93. package/dist/power.d.ts +19 -0
  94. package/dist/power.d.ts.map +1 -0
  95. package/dist/power.js +35 -0
  96. package/dist/remote.d.ts +156 -0
  97. package/dist/remote.d.ts.map +1 -0
  98. package/dist/remote.js +115 -0
  99. package/dist/screen.d.ts +25 -0
  100. package/dist/screen.d.ts.map +1 -0
  101. package/dist/screen.js +23 -0
  102. package/dist/shortcut.d.ts +2 -0
  103. package/dist/shortcut.d.ts.map +1 -0
  104. package/dist/shortcut.js +44 -0
  105. package/dist/testing.d.ts +6 -0
  106. package/dist/testing.d.ts.map +1 -0
  107. package/dist/testing.js +9 -0
  108. package/dist/theme.d.ts +12 -0
  109. package/dist/theme.d.ts.map +1 -0
  110. package/dist/theme.js +13 -0
  111. package/dist/tray.d.ts +18 -0
  112. package/dist/tray.d.ts.map +1 -0
  113. package/dist/tray.js +23 -0
  114. package/dist/types.d.ts +16 -0
  115. package/dist/types.d.ts.map +1 -0
  116. package/dist/types.js +1 -0
  117. package/dist/updater.d.ts +36 -0
  118. package/dist/updater.d.ts.map +1 -0
  119. package/dist/updater.js +58 -0
  120. package/dist/window.d.ts +154 -0
  121. package/dist/window.d.ts.map +1 -0
  122. package/dist/window.js +205 -0
  123. package/dist/wire.d.ts +26 -0
  124. package/dist/wire.d.ts.map +1 -0
  125. package/dist/wire.js +328 -0
  126. package/dist/worker-host.d.ts +6 -0
  127. package/dist/worker-host.d.ts.map +1 -0
  128. package/dist/worker-host.js +36 -0
  129. package/dist/worker.d.ts +62 -0
  130. package/dist/worker.d.ts.map +1 -0
  131. package/dist/worker.js +86 -0
  132. package/package.json +188 -3
package/dist/client.js ADDED
@@ -0,0 +1,545 @@
1
+ // Transport client for the host call protocol (see packages/native/PROTOCOL.md).
2
+ import { KrateError } from "./errors.js";
3
+ import { findMock, mockFn, mockSignal } from "./mock.js";
4
+ import { FrameReader, buildFrame, encodeFrame, encodeValue } from "./wire.js";
5
+ const CT = "application/x-krate-frames";
6
+ let nextId = 1;
7
+ function abortReason(s) {
8
+ return s.reason !== undefined ? s.reason : new DOMException("This operation was aborted", "AbortError");
9
+ }
10
+ function transport(e) {
11
+ if (e instanceof KrateError)
12
+ return e;
13
+ return new KrateError("transport", e instanceof Error ? e.message : String(e));
14
+ }
15
+ function toKrateError(err) {
16
+ return new KrateError(String(err?.code ?? "internal"), String(err?.message ?? ""), err?.data ?? null);
17
+ }
18
+ function randomId() {
19
+ const c = globalThis.crypto;
20
+ if (c && typeof c.randomUUID === "function")
21
+ return c.randomUUID();
22
+ return Math.random().toString(36).slice(2) + Date.now().toString(36);
23
+ }
24
+ export function createClient(options = {}) {
25
+ const fetchFn = options.fetch ?? ((i, init) => globalThis.fetch(i, init));
26
+ const origin = options.origin ?? "";
27
+ const windowId = options.windowId ?? globalThis.__KRATE_WINDOW__ ?? randomId();
28
+ const hdr = { "x-krate-window": windowId };
29
+ let closed = false;
30
+ // ---- calls ----
31
+ let queue = [];
32
+ const byId = new Map();
33
+ const inflight = new Map();
34
+ function postCancel(body) {
35
+ if (closed)
36
+ return;
37
+ try {
38
+ fetchFn(origin + "/__krate/cancel", {
39
+ method: "POST",
40
+ headers: { ...hdr, "content-type": CT },
41
+ body: encodeFrame(body),
42
+ }).catch(() => { });
43
+ }
44
+ catch {
45
+ // best effort
46
+ }
47
+ }
48
+ function detach(w) {
49
+ if (w.signal && w.onAbort)
50
+ w.signal.removeEventListener("abort", w.onAbort);
51
+ }
52
+ function abandon(rec) {
53
+ if (rec.key && inflight.get(rec.key) === rec)
54
+ inflight.delete(rec.key);
55
+ if (rec.sent && !rec.settled)
56
+ postCancel({ ids: [rec.id] });
57
+ }
58
+ function addWaiter(rec, resolve, reject, signal) {
59
+ const w = { resolve, reject, signal, rec };
60
+ if (signal) {
61
+ w.onAbort = () => {
62
+ const r = w.rec;
63
+ const i = r.waiters.indexOf(w);
64
+ if (i < 0)
65
+ return;
66
+ r.waiters.splice(i, 1);
67
+ reject(abortReason(signal));
68
+ if (r.waiters.length === 0)
69
+ abandon(r);
70
+ };
71
+ signal.addEventListener("abort", w.onAbort, { once: true });
72
+ }
73
+ rec.waiters.push(w);
74
+ }
75
+ function finish(rec, how, v) {
76
+ if (rec.settled)
77
+ return;
78
+ rec.settled = true;
79
+ byId.delete(rec.id);
80
+ if (rec.key && inflight.get(rec.key) === rec)
81
+ inflight.delete(rec.key);
82
+ const ws = rec.waiters;
83
+ rec.waiters = [];
84
+ for (const w of ws) {
85
+ detach(w);
86
+ w[how](v);
87
+ }
88
+ }
89
+ function enqueue(kind, fn, args, opts, resolve, reject) {
90
+ const signal = opts?.signal;
91
+ if (signal?.aborted) {
92
+ reject(abortReason(signal));
93
+ return;
94
+ }
95
+ const rec = {
96
+ id: nextId++,
97
+ fn,
98
+ args,
99
+ kind,
100
+ dedupe: kind === "call" && !!opts?.dedupe,
101
+ waiters: [],
102
+ sent: false,
103
+ settled: false,
104
+ };
105
+ addWaiter(rec, resolve, reject, signal);
106
+ queue.push(rec);
107
+ if (queue.length === 1)
108
+ queueMicrotask(flush);
109
+ }
110
+ function flush() {
111
+ const batch = queue;
112
+ queue = [];
113
+ const ctx = { blobs: [] };
114
+ const calls = [];
115
+ const recs = [];
116
+ for (const rec of batch) {
117
+ if (rec.waiters.length === 0)
118
+ continue;
119
+ const mark = ctx.blobs.length;
120
+ let tree;
121
+ try {
122
+ tree = rec.args.map((a, i) => encodeValue(a, ctx, `argument ${i}`));
123
+ }
124
+ catch (e) {
125
+ ctx.blobs.length = mark;
126
+ finish(rec, "reject", e);
127
+ continue;
128
+ }
129
+ if (rec.dedupe && ctx.blobs.length === mark) {
130
+ const key = rec.fn + "\0" + JSON.stringify(tree);
131
+ const ex = inflight.get(key);
132
+ if (ex && !ex.settled) {
133
+ for (const w of rec.waiters) {
134
+ w.rec = ex;
135
+ ex.waiters.push(w);
136
+ }
137
+ rec.waiters = [];
138
+ rec.settled = true;
139
+ continue;
140
+ }
141
+ rec.key = key;
142
+ inflight.set(key, rec);
143
+ }
144
+ rec.sent = true;
145
+ byId.set(rec.id, rec);
146
+ calls.push({ id: rec.id, fn: rec.fn, args: tree });
147
+ recs.push(rec);
148
+ }
149
+ if (recs.length === 0)
150
+ return;
151
+ let body;
152
+ try {
153
+ body = buildFrame({ calls }, ctx.blobs);
154
+ }
155
+ catch (e) {
156
+ for (const r of recs)
157
+ finish(r, "reject", e);
158
+ return;
159
+ }
160
+ void send(recs, body);
161
+ }
162
+ function failAll(recs, e) {
163
+ for (const r of recs)
164
+ finish(r, "reject", e);
165
+ }
166
+ async function send(recs, body) {
167
+ try {
168
+ const res = await fetchFn(origin + "/__krate/call", {
169
+ method: "POST",
170
+ headers: { ...hdr, "content-type": CT },
171
+ body: body,
172
+ });
173
+ if (!res.ok || !res.body) {
174
+ let e = new KrateError("transport", `host returned HTTP ${res.status}`);
175
+ if (res.body) {
176
+ try {
177
+ const f = await new FrameReader(res.body).next();
178
+ const err = f?.value?.error;
179
+ if (err)
180
+ e = toKrateError(err);
181
+ }
182
+ catch {
183
+ // keep the HTTP error
184
+ }
185
+ }
186
+ failAll(recs, e);
187
+ return;
188
+ }
189
+ const reader = new FrameReader(res.body);
190
+ for (;;) {
191
+ const f = await reader.next();
192
+ if (!f)
193
+ break;
194
+ const m = f.value;
195
+ if (m && m.error && m.id === undefined) {
196
+ failAll(recs, toKrateError(m.error));
197
+ return;
198
+ }
199
+ const rec = m && typeof m.id === "number" ? byId.get(m.id) : undefined;
200
+ if (!rec)
201
+ continue;
202
+ if ("err" in m)
203
+ finish(rec, "reject", toKrateError(m.err));
204
+ else if ("stream" in m) {
205
+ const sid = String(m.stream);
206
+ if (rec.kind === "stream") {
207
+ if (rec.waiters.length === 0)
208
+ postCancel({ streams: [sid] });
209
+ finish(rec, "resolve", sid);
210
+ }
211
+ else {
212
+ postCancel({ streams: [sid] });
213
+ finish(rec, "reject", new KrateError("protocol", `${rec.fn} returned a stream; use stream()`));
214
+ }
215
+ }
216
+ else if ("ok" in m) {
217
+ if (rec.kind === "stream")
218
+ finish(rec, "reject", new KrateError("protocol", `${rec.fn} did not return a stream`));
219
+ else
220
+ finish(rec, "resolve", m.ok);
221
+ }
222
+ }
223
+ for (const r of recs)
224
+ finish(r, "reject", new KrateError("transport", "no result"));
225
+ }
226
+ catch (e) {
227
+ failAll(recs, transport(e));
228
+ }
229
+ }
230
+ function call(fn, args = [], opts) {
231
+ const m = findMock(fn);
232
+ if (m) {
233
+ return new Promise((resolve, reject) => {
234
+ if (opts?.signal?.aborted)
235
+ return reject(abortReason(opts.signal));
236
+ try {
237
+ const f = mockFn(m, fn);
238
+ args.forEach((a, i) => encodeValue(a, { blobs: [] }, `argument ${i}`));
239
+ Promise.resolve(f(...args)).then(resolve, reject);
240
+ }
241
+ catch (e) {
242
+ reject(e);
243
+ }
244
+ });
245
+ }
246
+ return new Promise((resolve, reject) => enqueue("call", fn, args, opts, resolve, reject));
247
+ }
248
+ // ---- streams ----
249
+ function stream(fn, args = [], opts) {
250
+ const m = findMock(fn);
251
+ if (m)
252
+ return mockStream(m, fn, args, opts);
253
+ let sid;
254
+ let reader;
255
+ let ctrl;
256
+ let done = false;
257
+ let ended = false;
258
+ let reason;
259
+ let chain = Promise.resolve();
260
+ const signal = opts?.signal;
261
+ function close() {
262
+ if (done)
263
+ return;
264
+ done = true;
265
+ signal?.removeEventListener("abort", onAbort);
266
+ ctrl?.abort();
267
+ void reader?.cancel();
268
+ if (sid && !ended)
269
+ postCancel({ streams: [sid] });
270
+ }
271
+ function onAbort() {
272
+ reason = { v: abortReason(signal) };
273
+ close();
274
+ }
275
+ signal?.addEventListener("abort", onAbort, { once: true });
276
+ async function open() {
277
+ sid = await new Promise((resolve, reject) => enqueue("stream", fn, args, { signal }, resolve, reject));
278
+ if (done) {
279
+ // closed while the call was in flight
280
+ postCancel({ streams: [sid] });
281
+ return;
282
+ }
283
+ ctrl = new AbortController();
284
+ const res = await fetchFn(origin + "/__krate/stream/" + encodeURIComponent(sid), {
285
+ method: "GET",
286
+ headers: hdr,
287
+ signal: ctrl.signal,
288
+ });
289
+ if (!res.ok || !res.body)
290
+ throw new KrateError("transport", `stream returned HTTP ${res.status}`);
291
+ reader = new FrameReader(res.body);
292
+ }
293
+ async function step() {
294
+ if (done) {
295
+ if (reason)
296
+ throw reason.v;
297
+ return { done: true, value: undefined };
298
+ }
299
+ try {
300
+ if (!reader)
301
+ await open();
302
+ if (done || !reader) {
303
+ if (reason)
304
+ throw reason.v;
305
+ return { done: true, value: undefined };
306
+ }
307
+ const f = await reader.next();
308
+ if (done) {
309
+ if (reason)
310
+ throw reason.v;
311
+ return { done: true, value: undefined };
312
+ }
313
+ if (!f)
314
+ throw new KrateError("transport", "stream closed before end");
315
+ const v = f.value;
316
+ if (v && "v" in v)
317
+ return { done: false, value: v.v };
318
+ if (v && v.end) {
319
+ ended = true;
320
+ close();
321
+ return { done: true, value: undefined };
322
+ }
323
+ if (v && v.err) {
324
+ ended = true;
325
+ close();
326
+ throw toKrateError(v.err);
327
+ }
328
+ throw new KrateError("protocol", "unexpected stream frame");
329
+ }
330
+ catch (e) {
331
+ if (!reason && signal?.aborted)
332
+ reason = { v: abortReason(signal) };
333
+ if (reason) {
334
+ close();
335
+ throw reason.v;
336
+ }
337
+ if (done && !(e instanceof KrateError))
338
+ return { done: true, value: undefined };
339
+ ended = e instanceof KrateError && e.code !== "transport";
340
+ close();
341
+ throw transport(e);
342
+ }
343
+ }
344
+ const it = {
345
+ [Symbol.asyncIterator]() {
346
+ return it;
347
+ },
348
+ next() {
349
+ const p = chain.then(step);
350
+ chain = p.catch(() => { });
351
+ return p;
352
+ },
353
+ return() {
354
+ close();
355
+ return Promise.resolve({ done: true, value: undefined });
356
+ },
357
+ };
358
+ return it;
359
+ }
360
+ function mockStream(m, fn, args, opts) {
361
+ let inner;
362
+ const open = async () => {
363
+ const r = await mockFn(m, fn)(...args);
364
+ if (r && typeof r[Symbol.asyncIterator] === "function")
365
+ return r[Symbol.asyncIterator]();
366
+ if (r && typeof r[Symbol.iterator] === "function") {
367
+ const sync = r[Symbol.iterator]();
368
+ return { next: async () => sync.next(), return: async () => ({ done: true, value: undefined }) };
369
+ }
370
+ throw new KrateError("protocol", `mock ${fn} did not return an iterable`);
371
+ };
372
+ const it = {
373
+ [Symbol.asyncIterator]() {
374
+ return it;
375
+ },
376
+ async next() {
377
+ if (opts?.signal?.aborted)
378
+ throw abortReason(opts.signal);
379
+ inner ?? (inner = await open());
380
+ return inner.next();
381
+ },
382
+ async return() {
383
+ await inner?.return?.();
384
+ return { done: true, value: undefined };
385
+ },
386
+ };
387
+ return it;
388
+ }
389
+ const sigs = new Map();
390
+ let sigCtrl;
391
+ let sigGen = 0;
392
+ let sigTimer;
393
+ let backoff = 100;
394
+ let connectPending = false;
395
+ function signal(name) {
396
+ const mocked = mockSignal(name);
397
+ if (mocked)
398
+ return mocked;
399
+ let e = sigs.get(name);
400
+ if (!e) {
401
+ const entry = { value: undefined, has: false, subs: new Set(), read: undefined };
402
+ let read;
403
+ if (options.createSignal) {
404
+ const [r, w] = options.createSignal(undefined);
405
+ read = r;
406
+ entry.write = w;
407
+ }
408
+ else {
409
+ read = () => entry.value;
410
+ }
411
+ const sig = read;
412
+ sig.subscribe = (fn) => {
413
+ entry.subs.add(fn);
414
+ return () => {
415
+ entry.subs.delete(fn);
416
+ };
417
+ };
418
+ entry.read = sig;
419
+ sigs.set(name, entry);
420
+ e = entry;
421
+ scheduleConnect();
422
+ }
423
+ return e.read;
424
+ }
425
+ function scheduleConnect() {
426
+ if (connectPending || closed)
427
+ return;
428
+ connectPending = true;
429
+ queueMicrotask(() => {
430
+ connectPending = false;
431
+ void connect();
432
+ });
433
+ }
434
+ function apply(name, v) {
435
+ const e = sigs.get(name);
436
+ if (!e)
437
+ return;
438
+ if (e.has && Object.is(e.value, v))
439
+ return;
440
+ e.has = true;
441
+ e.value = v;
442
+ e.write?.(v);
443
+ for (const fn of [...e.subs])
444
+ fn(v);
445
+ }
446
+ async function connect() {
447
+ if (closed || sigs.size === 0)
448
+ return;
449
+ if (sigTimer !== undefined)
450
+ clearTimeout(sigTimer);
451
+ sigTimer = undefined;
452
+ sigCtrl?.abort();
453
+ const my = ++sigGen;
454
+ const ctrl = (sigCtrl = new AbortController());
455
+ try {
456
+ const names = [...sigs.keys()].map(encodeURIComponent).join(",");
457
+ const res = await fetchFn(origin + "/__krate/signals?names=" + names, { headers: hdr, signal: ctrl.signal });
458
+ if (!res.ok || !res.body)
459
+ throw new Error(`HTTP ${res.status}`);
460
+ const reader = new FrameReader(res.body);
461
+ for (;;) {
462
+ const f = await reader.next();
463
+ if (!f)
464
+ break;
465
+ if (my !== sigGen)
466
+ return;
467
+ const m = f.value;
468
+ if (m && typeof m.sig === "string") {
469
+ backoff = 100;
470
+ apply(m.sig, m.v);
471
+ }
472
+ }
473
+ }
474
+ catch {
475
+ // fall through to reconnect
476
+ }
477
+ if (my !== sigGen || closed)
478
+ return;
479
+ sigTimer = setTimeout(() => void connect(), backoff);
480
+ backoff = Math.min(backoff * 2, 5000);
481
+ }
482
+ function close() {
483
+ closed = true;
484
+ sigGen++;
485
+ sigCtrl?.abort();
486
+ if (sigTimer !== undefined)
487
+ clearTimeout(sigTimer);
488
+ }
489
+ return { call, stream, signal, close };
490
+ }
491
+ // hostBridge returns globalThis.__krateHost when it can dispatch calls
492
+ // in-process, else undefined (the webview, Node, tests).
493
+ export function hostBridge() {
494
+ const h = globalThis.__krateHost;
495
+ return h && typeof h.call === "function" && typeof h.stream === "function" && typeof h.signal === "function" ? h : undefined;
496
+ }
497
+ // createHostClient is the client for TS host code: calls go straight into the
498
+ // shell's registry, with no HTTP and no permission gate (host code is
499
+ // trusted). Mocks from @krate/app/testing still take precedence.
500
+ export function createHostClient(bridge) {
501
+ const sigs = new Map();
502
+ const mocked = createClient({ fetch: () => Promise.reject(new KrateError("transport", "no HTTP transport in host code")) });
503
+ const wrapErr = (e) => {
504
+ throw e instanceof KrateError ? e : toKrateError(e);
505
+ };
506
+ return {
507
+ call(fn, args = [], opts) {
508
+ if (findMock(fn))
509
+ return mocked.call(fn, args, opts);
510
+ if (opts?.signal?.aborted)
511
+ return Promise.reject(abortReason(opts.signal));
512
+ return bridge.call(fn, args).then((v) => v, wrapErr);
513
+ },
514
+ stream(fn, args = [], opts) {
515
+ if (findMock(fn))
516
+ return mocked.stream(fn, args, opts);
517
+ const inner = bridge.stream(fn, args)[Symbol.asyncIterator]();
518
+ const it = {
519
+ [Symbol.asyncIterator]() {
520
+ return it;
521
+ },
522
+ next: () => (opts?.signal?.aborted ? Promise.reject(abortReason(opts.signal)) : inner.next().catch(wrapErr)),
523
+ return: async () => {
524
+ await inner.return?.();
525
+ return { done: true, value: undefined };
526
+ },
527
+ };
528
+ return it;
529
+ },
530
+ signal(name) {
531
+ const m = mockSignal(name);
532
+ if (m)
533
+ return m;
534
+ let r = sigs.get(name);
535
+ if (!r) {
536
+ const s = bridge.signal(name);
537
+ const read = (() => s.get());
538
+ read.subscribe = (fn) => s.subscribe(fn);
539
+ sigs.set(name, (r = read));
540
+ }
541
+ return r;
542
+ },
543
+ close() { },
544
+ };
545
+ }
@@ -0,0 +1,19 @@
1
+ export declare function readText(): Promise<string>;
2
+ export declare function writeText(text: string): Promise<void>;
3
+ export declare function readImage(): Promise<Uint8Array | null>;
4
+ export declare function writeImage(png: Uint8Array): Promise<void>;
5
+ export declare function readFiles(): Promise<string[]>;
6
+ export declare function writeFiles(paths: string[]): Promise<void>;
7
+ export declare function clear(): Promise<void>;
8
+ export interface ClipboardData {
9
+ text?: string;
10
+ html?: string;
11
+ rtf?: string;
12
+ }
13
+ export declare function write(data: ClipboardData): Promise<void>;
14
+ export declare function readHtml(): Promise<string>;
15
+ export declare function readRtf(): Promise<string>;
16
+ export declare function formats(): Promise<string[]>;
17
+ export declare function readFormat(name: string): Promise<Uint8Array | null>;
18
+ export declare function writeFormat(name: string, data: Uint8Array): Promise<void>;
19
+ //# sourceMappingURL=clipboard.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"AAIA,wBAAgB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAE1C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErD;AAGD,wBAAgB,SAAS,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAEtD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzD;AAED,wBAAgB,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAE7C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzD;AAED,wBAAgB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAErC;AAKD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAExD;AAGD,wBAAgB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAE1C;AAGD,wBAAgB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAEzC;AAID,wBAAgB,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAE3C;AAKD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAEnE;AAGD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE"}
@@ -0,0 +1,51 @@
1
+ // System clipboard. Writing needs the "clipboard" permission; reading needs
2
+ // "clipboard:read".
3
+ import { call } from "./index.js";
4
+ export function readText() {
5
+ return call("krate/clipboard.readText");
6
+ }
7
+ export function writeText(text) {
8
+ return call("krate/clipboard.writeText", [text]);
9
+ }
10
+ // readImage resolves to PNG bytes, or null when the clipboard has no image.
11
+ export function readImage() {
12
+ return call("krate/clipboard.readImage");
13
+ }
14
+ export function writeImage(png) {
15
+ return call("krate/clipboard.writeImage", [png]);
16
+ }
17
+ export function readFiles() {
18
+ return call("krate/clipboard.readFiles");
19
+ }
20
+ export function writeFiles(paths) {
21
+ return call("krate/clipboard.writeFiles", [paths]);
22
+ }
23
+ export function clear() {
24
+ return call("krate/clipboard.clear");
25
+ }
26
+ export function write(data) {
27
+ return call("krate/clipboard.write", [data]);
28
+ }
29
+ // readHtml resolves to the HTML fragment on the clipboard, or "".
30
+ export function readHtml() {
31
+ return call("krate/clipboard.readHtml");
32
+ }
33
+ // readRtf resolves to the RTF document on the clipboard, or "".
34
+ export function readRtf() {
35
+ return call("krate/clipboard.readRtf");
36
+ }
37
+ // formats lists what is on the clipboard: MIME types where the platform has
38
+ // one ("text/plain", "text/html", "text/rtf", "image/png"), else native names.
39
+ export function formats() {
40
+ return call("krate/clipboard.formats");
41
+ }
42
+ // readFormat resolves to the bytes of one format, or null when absent. A MIME
43
+ // name is mapped to the platform's own (a UTI on macOS, a registered format
44
+ // on Windows); text/html is the fragment, not the Windows CF_HTML envelope.
45
+ export function readFormat(name) {
46
+ return call("krate/clipboard.readFormat", [name]);
47
+ }
48
+ // writeFormat replaces the clipboard with a single format.
49
+ export function writeFormat(name, data) {
50
+ return call("krate/clipboard.writeFormat", [name, data]);
51
+ }
@@ -0,0 +1,44 @@
1
+ export type SameSite = "none" | "lax" | "strict" | "";
2
+ export interface Cookie {
3
+ name: string;
4
+ value: string;
5
+ domain: string;
6
+ path: string;
7
+ /** Expiry in milliseconds since the epoch, null for a session cookie. */
8
+ expires: number | null;
9
+ secure: boolean;
10
+ httpOnly: boolean;
11
+ sameSite: SameSite;
12
+ }
13
+ export interface CookieInput {
14
+ name: string;
15
+ value: string;
16
+ /** Default: the host of the URL. */
17
+ domain?: string;
18
+ /** Default "/". */
19
+ path?: string;
20
+ expires?: number | Date | null;
21
+ secure?: boolean;
22
+ httpOnly?: boolean;
23
+ sameSite?: SameSite;
24
+ }
25
+ export interface ClearOptions {
26
+ cookies?: boolean;
27
+ /** The HTTP and memory cache. */
28
+ cache?: boolean;
29
+ /** localStorage, sessionStorage, IndexedDB and service workers. */
30
+ storage?: boolean;
31
+ }
32
+ /** list resolves to the cookies that would be sent to the URL. */
33
+ declare function cookiesList(url?: string): Promise<Cookie[]>;
34
+ /** get resolves to the cookie with this name, or null. */
35
+ declare function cookiesGet(name: string, url?: string): Promise<Cookie | null>;
36
+ /** set stores a cookie. */
37
+ declare function cookiesSet(cookie: CookieInput, url?: string): Promise<void>;
38
+ /** delete removes the cookies with this name. */
39
+ declare function cookiesDelete(name: string, url?: string): Promise<void>;
40
+ export { cookiesDelete as delete };
41
+ /** clearSiteData removes cookies, cache and storage; with no options, all of it. */
42
+ declare function cookiesClearSiteData(options?: ClearOptions): Promise<void>;
43
+ export { cookiesList as list, cookiesGet as get, cookiesSet as set, cookiesClearSiteData as clearSiteData };
44
+ //# sourceMappingURL=cookies.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../src/cookies.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,EAAE,CAAC;AAEtD,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,kEAAkE;AAClE,iBAAS,WAAW,CAAC,GAAG,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEhD;AAED,0DAA0D;AAC1D,iBAAS,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAElE;AAED,2BAA2B;AAC3B,iBAAS,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAehE;AAED,iDAAiD;AACjD,iBAAS,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;AACD,OAAO,EAAE,aAAa,IAAI,MAAM,EAAE,CAAC;AAEnC,oFAAoF;AACpF,iBAAS,oBAAoB,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE;AAED,OAAO,EAAE,WAAW,IAAI,IAAI,EAAE,UAAU,IAAI,GAAG,EAAE,UAAU,IAAI,GAAG,EAAE,oBAAoB,IAAI,aAAa,EAAE,CAAC"}