@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/events.js ADDED
@@ -0,0 +1,47 @@
1
+ // Shared by the UI half of the SDK: turn a host event stream into callbacks.
2
+ import { stream } from "./index.js";
3
+ import { isKrateError } from "./errors.js";
4
+ const RETRY_MS = 250;
5
+ // subscribe calls fn for every value of the host stream `id` until the
6
+ // returned function is called. A dropped stream is reopened; errors that will
7
+ // not go away (not_found for a missing permission, unsupported) stop it.
8
+ export function subscribe(id, fn, opts = {}) {
9
+ const ac = new AbortController();
10
+ void (async () => {
11
+ while (!ac.signal.aborted) {
12
+ try {
13
+ for await (const v of stream(id, [], { signal: ac.signal })) {
14
+ if (ac.signal.aborted)
15
+ return;
16
+ try {
17
+ fn(v);
18
+ }
19
+ catch (e) {
20
+ // A throwing listener must not end the subscription.
21
+ console.error(e);
22
+ }
23
+ }
24
+ }
25
+ catch (e) {
26
+ if (ac.signal.aborted)
27
+ return;
28
+ if (isKrateError(e) && (e.code === "not_found" || e.code === "unsupported" || e.code === "bad_args")) {
29
+ opts.onError?.(e);
30
+ return;
31
+ }
32
+ }
33
+ if (ac.signal.aborted)
34
+ return;
35
+ await new Promise((r) => setTimeout(r, RETRY_MS));
36
+ }
37
+ })();
38
+ return () => ac.abort();
39
+ }
40
+ // drop undefined values so Go sees the field as absent.
41
+ export function clean(o) {
42
+ const out = {};
43
+ for (const [k, v] of Object.entries(o))
44
+ if (v !== undefined)
45
+ out[k] = v;
46
+ return out;
47
+ }
@@ -0,0 +1,10 @@
1
+ export interface ExtensionInfo {
2
+ id: string;
3
+ name: string;
4
+ enabled: boolean;
5
+ }
6
+ export declare function declaredExtensions(): Promise<string[]>;
7
+ export declare function listExtensions(): Promise<ExtensionInfo[]>;
8
+ export declare function loadExtension(name: string): Promise<ExtensionInfo>;
9
+ export declare function removeExtension(id: string): Promise<void>;
10
+ //# sourceMappingURL=extension.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAGD,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAEtD;AAGD,wBAAgB,cAAc,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAEzD;AAGD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAElE;AAGD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzD"}
@@ -0,0 +1,25 @@
1
+ // The browser extensions an app packages (native.extensions). Needs the
2
+ // "extension" permission.
3
+ //
4
+ // WebView2 loads unpacked Chromium extensions into the app's profile. WKWebView
5
+ // loads them on macOS 15.4 and later. WebKitGTK has no extension API: every
6
+ // call rejects with code "unsupported". Extensions are named, not addressed by
7
+ // path, so a page cannot load code from an arbitrary place; the declared ones
8
+ // load when the app starts.
9
+ import { call } from "./index.js";
10
+ // declaredExtensions lists the names from native.extensions.
11
+ export function declaredExtensions() {
12
+ return call("krate/extension.declared", []);
13
+ }
14
+ // listExtensions returns the extensions loaded now.
15
+ export function listExtensions() {
16
+ return call("krate/extension.list", []);
17
+ }
18
+ // loadExtension loads a declared extension by name.
19
+ export function loadExtension(name) {
20
+ return call("krate/extension.load", [name]);
21
+ }
22
+ // removeExtension unloads an extension by id.
23
+ export function removeExtension(id) {
24
+ return call("krate/extension.remove", [id]);
25
+ }
@@ -0,0 +1,18 @@
1
+ export type FakeHandler = (args: any[], ctx: {
2
+ signal: AbortSignal;
3
+ id: number;
4
+ }) => unknown;
5
+ export interface FakeHost {
6
+ fetch: (input: string, init?: RequestInit) => Promise<Response>;
7
+ requests: string[];
8
+ batches: number[][];
9
+ cancelledIds: number[];
10
+ cancelledStreams: string[];
11
+ closedStreams: string[];
12
+ signalConnections: string[][];
13
+ setSignal(name: string, v: unknown): void;
14
+ dropSignals(): void;
15
+ windows: string[];
16
+ }
17
+ export declare function createFakeHost(registry: Record<string, FakeHandler>, initialSignals?: Record<string, unknown>): FakeHost;
18
+ //# sourceMappingURL=fakehost.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fakehost.d.ts","sourceRoot":"","sources":["../src/fakehost.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC;AAE7F,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEhE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,EAAE,CAAC;IAC9B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE1C,WAAW,IAAI,IAAI,CAAC;IAEpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAUD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,QAAQ,CAmL5H"}
@@ -0,0 +1,199 @@
1
+ // In-memory implementation of the host side of PROTOCOL.md, as a fetch
2
+ // function. For tests of client code and of @krate/app itself.
3
+ import { KrateError } from "./errors.js";
4
+ import { FrameReader, encodeFrame } from "./wire.js";
5
+ function framed(stream, status = 200) {
6
+ return new Response(stream, { status, headers: { "content-type": "application/x-krate-frames" } });
7
+ }
8
+ // createFakeHost builds a host from a registry keyed by "<module>.<Name>".
9
+ // A handler may return a value, a promise, or an async iterable (a stream).
10
+ // Throw KrateError to send an error frame.
11
+ export function createFakeHost(registry, initialSignals = {}) {
12
+ const signals = new Map(Object.entries(initialSignals));
13
+ const inflight = new Map();
14
+ const streams = new Map();
15
+ const sigConns = new Set();
16
+ let nextStream = 1;
17
+ const host = {
18
+ requests: [],
19
+ batches: [],
20
+ cancelledIds: [],
21
+ cancelledStreams: [],
22
+ closedStreams: [],
23
+ signalConnections: [],
24
+ windows: [],
25
+ setSignal(name, v) {
26
+ signals.set(name, v);
27
+ for (const c of sigConns) {
28
+ if (c.names.has(name))
29
+ c.ctrl.enqueue(encodeFrame({ sig: name, v }));
30
+ }
31
+ },
32
+ dropSignals() {
33
+ for (const c of sigConns) {
34
+ try {
35
+ c.ctrl.close();
36
+ }
37
+ catch {
38
+ // already closed
39
+ }
40
+ }
41
+ sigConns.clear();
42
+ },
43
+ async fetch(input, init) {
44
+ const url = new URL(input, "http://fake");
45
+ const method = (init?.method ?? "GET").toUpperCase();
46
+ host.requests.push(`${method} ${url.pathname}`);
47
+ const h = new Headers(init?.headers);
48
+ host.windows.push(h.get("x-krate-window") ?? "");
49
+ const sig = init?.signal ?? undefined;
50
+ if (url.pathname === "/__krate/call" && method === "POST")
51
+ return handleCall(init.body);
52
+ if (url.pathname === "/__krate/cancel" && method === "POST") {
53
+ const f = await new FrameReader(new Response(init.body).body).next();
54
+ const b = f.value;
55
+ for (const id of b.ids ?? []) {
56
+ host.cancelledIds.push(id);
57
+ inflight.get(id)?.abort();
58
+ }
59
+ for (const s of b.streams ?? []) {
60
+ host.cancelledStreams.push(s);
61
+ const it = streams.get(s);
62
+ if (it) {
63
+ streams.delete(s);
64
+ void it.return?.();
65
+ }
66
+ }
67
+ return new Response(null, { status: 204 });
68
+ }
69
+ if (url.pathname.startsWith("/__krate/stream/"))
70
+ return handleStream(url.pathname.slice("/__krate/stream/".length), sig);
71
+ if (url.pathname === "/__krate/signals")
72
+ return handleSignals(url.searchParams.get("names") ?? "", sig);
73
+ return new Response("not found", { status: 404 });
74
+ },
75
+ };
76
+ function handleCall(body) {
77
+ let calls;
78
+ return framedBody(async (ctrl) => {
79
+ try {
80
+ const f = await new FrameReader(new Response(body).body).next();
81
+ calls = f.value.calls;
82
+ }
83
+ catch (e) {
84
+ ctrl.enqueue(encodeFrame({ error: { code: "bad_request", message: String(e) } }));
85
+ ctrl.close();
86
+ return;
87
+ }
88
+ host.batches.push(calls.map((c) => c.id));
89
+ let pending = calls.length;
90
+ const finishOne = () => {
91
+ if (--pending === 0)
92
+ ctrl.close();
93
+ };
94
+ if (pending === 0)
95
+ ctrl.close();
96
+ for (const c of calls) {
97
+ const h = registry[c.fn];
98
+ const ac = new AbortController();
99
+ inflight.set(c.id, ac);
100
+ void (async () => {
101
+ let out;
102
+ try {
103
+ if (!h)
104
+ throw new KrateError("not_found", `unknown fn ${c.fn}`);
105
+ const r = await h(c.args, { signal: ac.signal, id: c.id });
106
+ if (r && typeof r[Symbol.asyncIterator] === "function") {
107
+ const sid = "s" + nextStream++;
108
+ streams.set(sid, r[Symbol.asyncIterator]());
109
+ out = { id: c.id, stream: sid };
110
+ }
111
+ else {
112
+ out = { id: c.id, ok: r === undefined ? null : r };
113
+ }
114
+ }
115
+ catch (e) {
116
+ const ke = e instanceof KrateError ? e : new KrateError("internal", e instanceof Error ? e.message : String(e));
117
+ out = { id: c.id, err: { code: ke.code, message: ke.message, data: ke.data } };
118
+ }
119
+ inflight.delete(c.id);
120
+ try {
121
+ ctrl.enqueue(encodeFrame(out));
122
+ }
123
+ catch {
124
+ // response already torn down
125
+ }
126
+ finishOne();
127
+ })();
128
+ }
129
+ });
130
+ }
131
+ function framedBody(start) {
132
+ return framed(new ReadableStream({ start }));
133
+ }
134
+ function handleStream(sid, sig) {
135
+ const it = streams.get(sid);
136
+ if (!it)
137
+ return new Response("gone", { status: 404 });
138
+ streams.delete(sid);
139
+ let closed = false;
140
+ const closeIt = () => {
141
+ if (closed)
142
+ return;
143
+ closed = true;
144
+ host.closedStreams.push(sid);
145
+ void it.return?.();
146
+ };
147
+ sig?.addEventListener("abort", closeIt, { once: true });
148
+ return framed(new ReadableStream({
149
+ async pull(ctrl) {
150
+ try {
151
+ const r = await it.next();
152
+ if (r.done) {
153
+ ctrl.enqueue(encodeFrame({ end: true }));
154
+ closed = true;
155
+ ctrl.close();
156
+ }
157
+ else {
158
+ ctrl.enqueue(encodeFrame({ v: r.value }));
159
+ }
160
+ }
161
+ catch (e) {
162
+ const ke = e instanceof KrateError ? e : new KrateError("internal", e instanceof Error ? e.message : String(e));
163
+ closed = true;
164
+ ctrl.enqueue(encodeFrame({ err: { code: ke.code, message: ke.message, data: ke.data } }));
165
+ ctrl.close();
166
+ }
167
+ },
168
+ cancel: closeIt,
169
+ }));
170
+ }
171
+ function handleSignals(namesParam, sig) {
172
+ const names = namesParam.split(",").filter(Boolean);
173
+ host.signalConnections.push(names);
174
+ let conn;
175
+ return framed(new ReadableStream({
176
+ start(ctrl) {
177
+ conn = { names: new Set(names), ctrl };
178
+ sigConns.add(conn);
179
+ for (const n of names)
180
+ if (signals.has(n))
181
+ ctrl.enqueue(encodeFrame({ sig: n, v: signals.get(n) }));
182
+ sig?.addEventListener("abort", () => {
183
+ sigConns.delete(conn);
184
+ try {
185
+ ctrl.error(new DOMException("aborted", "AbortError"));
186
+ }
187
+ catch {
188
+ // already closed
189
+ }
190
+ });
191
+ },
192
+ cancel() {
193
+ if (conn)
194
+ sigConns.delete(conn);
195
+ },
196
+ }));
197
+ }
198
+ return host;
199
+ }
package/dist/fs.d.ts ADDED
@@ -0,0 +1,26 @@
1
+ export interface DirEntry {
2
+ name: string;
3
+ isDir: boolean;
4
+ size: number;
5
+ modTime: Date;
6
+ }
7
+ export interface FileInfo {
8
+ name: string;
9
+ size: number;
10
+ isDir: boolean;
11
+ modTime: Date;
12
+ mode: number;
13
+ }
14
+ export declare function readFile(path: string): Promise<Uint8Array>;
15
+ export declare function readText(path: string): Promise<string>;
16
+ export declare function readDir(path: string): Promise<DirEntry[]>;
17
+ export declare function stat(path: string): Promise<FileInfo>;
18
+ export declare function exists(path: string): Promise<boolean>;
19
+ export declare function writeFile(path: string, data: Uint8Array): Promise<void>;
20
+ export declare function writeText(path: string, text: string): Promise<void>;
21
+ export declare function mkdir(path: string): Promise<void>;
22
+ export declare function remove(path: string, opts?: {
23
+ recursive?: boolean;
24
+ }): Promise<void>;
25
+ export declare function rename(from: string, to: string): Promise<void>;
26
+ //# sourceMappingURL=fs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,IAAI,CAAC;IAEd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAE1D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAEzD;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEpD;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAErD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAGD,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjD;AAGD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D"}
package/dist/fs.js ADDED
@@ -0,0 +1,38 @@
1
+ // Scoped file access. A path may be absolute or relative to the app data
2
+ // directory; it must lie inside the app directories or a path the user picked
3
+ // in a dialog, otherwise the call rejects with code "permission_denied" and
4
+ // data {permission: "fs", reason: "outside_scope", path}.
5
+ // Host ids krate/fs.*. Reads need fs:read, writes need fs.
6
+ import { call } from "./index.js";
7
+ export function readFile(path) {
8
+ return call("krate/fs.readFile", [path]);
9
+ }
10
+ export function readText(path) {
11
+ return call("krate/fs.readText", [path]);
12
+ }
13
+ export function readDir(path) {
14
+ return call("krate/fs.readDir", [path]);
15
+ }
16
+ export function stat(path) {
17
+ return call("krate/fs.stat", [path]);
18
+ }
19
+ export function exists(path) {
20
+ return call("krate/fs.exists", [path]);
21
+ }
22
+ export function writeFile(path, data) {
23
+ return call("krate/fs.writeFile", [path, data]);
24
+ }
25
+ export function writeText(path, text) {
26
+ return call("krate/fs.writeText", [path, text]);
27
+ }
28
+ // Creates the directory and any missing parents.
29
+ export function mkdir(path) {
30
+ return call("krate/fs.mkdir", [path]);
31
+ }
32
+ // A directory needs recursive: true unless it is empty.
33
+ export function remove(path, opts = {}) {
34
+ return call("krate/fs.remove", opts.recursive ? [path, true] : [path]);
35
+ }
36
+ export function rename(from, to) {
37
+ return call("krate/fs.rename", [from, to]);
38
+ }
package/dist/host.d.ts ADDED
@@ -0,0 +1,4 @@
1
+ import type { HostSignal } from "./types.js";
2
+ export type { HostSignal, ReadonlyHostSignal } from "./types.js";
3
+ export declare function hostSignal<T>(initial: T): HostSignal<T>;
4
+ //# sourceMappingURL=host.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEjE,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAuBvD"}
package/dist/host.js ADDED
@@ -0,0 +1,25 @@
1
+ export function hostSignal(initial) {
2
+ let value = initial;
3
+ const subs = new Set();
4
+ const sig = {
5
+ get: () => value,
6
+ set(v) {
7
+ value = v;
8
+ for (const fn of [...subs])
9
+ fn(v);
10
+ },
11
+ update(f) {
12
+ sig.set(f(value));
13
+ },
14
+ subscribe(fn) {
15
+ subs.add(fn);
16
+ return () => {
17
+ subs.delete(fn);
18
+ };
19
+ },
20
+ };
21
+ // The compiler-generated host entry finds signals by this brand and
22
+ // registers them under their export id (registerSignal(id, sig)).
23
+ Object.defineProperty(sig, "__krateHostSignal", { value: true });
24
+ return sig;
25
+ }
@@ -0,0 +1,19 @@
1
+ import { type Client } from "./client.js";
2
+ import type { CallOptions, ReadonlyHostSignal } from "./types.js";
3
+ export { KrateError, isKrateError } from "./errors.js";
4
+ export type { CallOptions, HostSignal, ReadonlyHostSignal } from "./types.js";
5
+ export { createClient, createHostClient } from "./client.js";
6
+ export type { Client, ClientOptions } from "./client.js";
7
+ export declare function getClient(): Client;
8
+ export declare function setClient(c: Client): void;
9
+ export declare function call<T = unknown>(fn: string, args?: unknown[], opts?: CallOptions): Promise<T>;
10
+ export declare function stream<T = unknown>(fn: string, args?: unknown[], opts?: CallOptions): AsyncIterable<T> & AsyncIterator<T>;
11
+ export declare const hostSignal: {
12
+ signal<T = unknown>(name: string): ReadonlyHostSignal<T, T | undefined>;
13
+ };
14
+ export declare const signal: <T = unknown>(name: string) => ReadonlyHostSignal<T, T | undefined>;
15
+ export declare const app: {
16
+ readonly origin: string;
17
+ readonly native: boolean;
18
+ };
19
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAOzD,wBAAgB,SAAS,IAAI,MAAM,CAIlC;AAID,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,OAAO,EAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAElG;AAED,wBAAgB,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,OAAO,EAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAE7H;AAED,eAAO,MAAM,UAAU;WACd,CAAC,kBAAkB,MAAM,GAAG,kBAAkB,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;CAGxE,CAAC;AAEF,eAAO,MAAM,MAAM,GALV,CAAC,kBAAkB,MAAM,KAAG,kBAAkB,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAKjC,CAAC;AAExC,eAAO,MAAM,GAAG;qBACA,MAAM;qBAGN,OAAO;CAItB,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,40 @@
1
+ import { createClient, createHostClient, hostBridge } from "./client.js";
2
+ export { KrateError, isKrateError } from "./errors.js";
3
+ export { createClient, createHostClient } from "./client.js";
4
+ let current;
5
+ // getClient returns the shared client, creating it on first use. In TS host
6
+ // code (QuickJS in the shell, where __krateHost.call exists) it dispatches
7
+ // in-process into the shell's registry; in a page it uses HTTP.
8
+ export function getClient() {
9
+ if (current)
10
+ return current;
11
+ const b = hostBridge();
12
+ return (current = b ? createHostClient(b) : createClient());
13
+ }
14
+ // setClient replaces the shared client, for example to pass createSignal from
15
+ // @krate/runtime so host signals are reactive.
16
+ export function setClient(c) {
17
+ current = c;
18
+ }
19
+ export function call(fn, args = [], opts) {
20
+ return getClient().call(fn, args, opts);
21
+ }
22
+ export function stream(fn, args = [], opts) {
23
+ return getClient().stream(fn, args, opts);
24
+ }
25
+ export const hostSignal = {
26
+ signal(name) {
27
+ return getClient().signal(name);
28
+ },
29
+ };
30
+ export const signal = hostSignal.signal;
31
+ export const app = {
32
+ get origin() {
33
+ return typeof location !== "undefined" ? location.origin : "";
34
+ },
35
+ get native() {
36
+ if (typeof location === "undefined")
37
+ return false;
38
+ return location.protocol === "krate:" || location.origin === "https://app.localhost";
39
+ },
40
+ };
package/dist/kv.d.ts ADDED
@@ -0,0 +1,6 @@
1
+ export declare function get<T = unknown>(key: string): Promise<T | null>;
2
+ export declare function set(key: string, value: unknown): Promise<void>;
3
+ declare function del(key: string): Promise<void>;
4
+ export { del as delete };
5
+ export declare function keys(prefix?: string): Promise<string[]>;
6
+ //# sourceMappingURL=kv.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../src/kv.ts"],"names":[],"mappings":"AAMA,wBAAgB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAE/D;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,iBAAS,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvC;AACD,OAAO,EAAE,GAAG,IAAI,MAAM,EAAE,CAAC;AAGzB,wBAAgB,IAAI,CAAC,MAAM,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnD"}
package/dist/kv.js ADDED
@@ -0,0 +1,19 @@
1
+ // Key-value store in the app database. Values can be anything the host
2
+ // protocol carries: JSON values, Uint8Array, Date, Map, Set. Host ids
3
+ // krate/kv.*; permission kv.
4
+ import { call } from "./index.js";
5
+ // Resolves null when the key is missing (a stored null reads the same).
6
+ export function get(key) {
7
+ return call("krate/kv.get", [key], { dedupe: true });
8
+ }
9
+ export function set(key, value) {
10
+ return call("krate/kv.set", [key, value]);
11
+ }
12
+ function del(key) {
13
+ return call("krate/kv.delete", [key]);
14
+ }
15
+ export { del as delete };
16
+ // Keys that start with prefix, in byte order.
17
+ export function keys(prefix = "") {
18
+ return call("krate/kv.keys", prefix ? [prefix] : [], { dedupe: true });
19
+ }
@@ -0,0 +1,22 @@
1
+ import { type SubscribeOptions } from "./events.js";
2
+ export interface SecondInstance {
3
+ args: string[];
4
+ dir: string;
5
+ urls: string[];
6
+ }
7
+ export declare function quit(): Promise<void>;
8
+ export declare function relaunch(): Promise<void>;
9
+ export declare function supports(capability: string): Promise<boolean>;
10
+ export declare function onSecondInstance(fn: (e: SecondInstance) => void, opts?: SubscribeOptions): () => void;
11
+ export declare function onOpenURL(fn: (url: string) => void, opts?: SubscribeOptions): () => void;
12
+ export interface OpenFileEvent {
13
+ paths: string[];
14
+ index: number;
15
+ source: "launch" | "second-instance" | "system";
16
+ }
17
+ export declare function openedFiles(): Promise<string[]>;
18
+ export interface OpenFileOptions extends SubscribeOptions {
19
+ replay?: boolean;
20
+ }
21
+ export declare function onOpenFile(fn: (path: string) => void, opts?: OpenFileOptions): () => void;
22
+ //# sourceMappingURL=lifecycle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IAEZ,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAgB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpC;AAED,wBAAgB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAExC;AAOD,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7D;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAErG;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAIxF;AAID,MAAM,WAAW,aAAa;IAE5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,KAAK,EAAE,MAAM,CAAC;IAGd,MAAM,EAAE,QAAQ,GAAG,iBAAiB,GAAG,QAAQ,CAAC;CACjD;AAMD,wBAAgB,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAE/C;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IAGvD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAKD,wBAAgB,UAAU,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,IAAI,GAAE,eAAoB,GAAG,MAAM,IAAI,CA6C7F"}
@@ -0,0 +1,85 @@
1
+ // Application lifecycle: quit, relaunch, capability checks and second-instance
2
+ // events. Needs the "app" permission.
3
+ import { call } from "./index.js";
4
+ import { subscribe } from "./events.js";
5
+ export function quit() {
6
+ return call("krate/app.quit");
7
+ }
8
+ export function relaunch() {
9
+ return call("krate/app.relaunch");
10
+ }
11
+ // supports reports whether a capability works right now: "dialog",
12
+ // "clipboard", "menu", "tray", "notify", "shortcut", "media", "window",
13
+ // "window:alwaysOnTop", "window:fullscreen", "window:frameless",
14
+ // "window:position", "window:release", "badge", "screen", "power", "login",
15
+ // "theme", "crash", "page", "downloads", "cookies".
16
+ export function supports(capability) {
17
+ return call("krate/app.supports", [capability], { dedupe: true });
18
+ }
19
+ export function onSecondInstance(fn, opts) {
20
+ return subscribe("krate/app.events", fn, opts);
21
+ }
22
+ export function onOpenURL(fn, opts) {
23
+ return onSecondInstance((e) => {
24
+ for (const u of e.urls)
25
+ fn(u);
26
+ }, opts);
27
+ }
28
+ // Every file the app was asked to open since it started, oldest first: the
29
+ // ones on its command line, then later ones. The app may read them through
30
+ // @krate/app/fs when it has the fs permission: a file the user opens this way
31
+ // is granted like one chosen in a dialog.
32
+ export function openedFiles() {
33
+ return call("krate/app.openedFiles");
34
+ }
35
+ // Calls fn with the path of each file the app is asked to open, once each.
36
+ // By default the files opened before this call come first, so a document that
37
+ // launched the app is not missed. Returns a function that stops listening.
38
+ export function onOpenFile(fn, opts = {}) {
39
+ const replay = opts.replay !== false;
40
+ let stopped = false;
41
+ let ready = false;
42
+ let delivered = 0;
43
+ const queue = [];
44
+ const give = (p) => {
45
+ try {
46
+ fn(p);
47
+ }
48
+ catch (e) {
49
+ console.error(e);
50
+ }
51
+ };
52
+ const handle = (e) => {
53
+ e.paths.forEach((p, i) => {
54
+ if (e.index + i >= delivered) {
55
+ delivered = e.index + i + 1;
56
+ give(p);
57
+ }
58
+ });
59
+ };
60
+ const stop = subscribe("krate/app.openFileEvents", (e) => {
61
+ if (ready)
62
+ handle(e);
63
+ else
64
+ queue.push(e);
65
+ }, opts);
66
+ call("krate/app.openedFiles")
67
+ .then((list) => {
68
+ if (stopped)
69
+ return;
70
+ if (replay)
71
+ list.forEach(give);
72
+ delivered = list.length;
73
+ ready = true;
74
+ for (const e of queue.splice(0))
75
+ handle(e);
76
+ })
77
+ .catch((e) => {
78
+ stop();
79
+ opts.onError?.(e);
80
+ });
81
+ return () => {
82
+ stopped = true;
83
+ stop();
84
+ };
85
+ }
@@ -0,0 +1,10 @@
1
+ export interface LoginItem {
2
+ enabled: boolean;
3
+ method: string;
4
+ }
5
+ export interface LoginOptions {
6
+ args?: string[];
7
+ }
8
+ export declare function getLoginItem(): Promise<LoginItem>;
9
+ export declare function setLoginItem(enabled: boolean, options?: LoginOptions): Promise<void>;
10
+ //# sourceMappingURL=login.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../src/login.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IAGjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAE3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAgB,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC,CAEjD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF"}
package/dist/login.js ADDED
@@ -0,0 +1,8 @@
1
+ // Start the app when the user logs in. Needs the "login" permission.
2
+ import { call } from "./index.js";
3
+ export function getLoginItem() {
4
+ return call("krate/login.get", []);
5
+ }
6
+ export function setLoginItem(enabled, options = {}) {
7
+ return call("krate/login.set", [enabled, { args: options.args ?? [] }]);
8
+ }