@domicile-desktop/component-library 0.0.0-alpha-7e37a30d1bac → 0.0.0-alpha-617f1cc7ddbb

package/README.md

@@ -16,6 +16,7 @@ Each export is `@domicile-desktop/component-library/<name>`.
 
 | Name | What it is |
 |---|---|
+| `app-host-frames` | `encodeFrame` and `frameDecoder`: the length-prefixed JSON an app module and `domicile-app-host` speak over stdio. |
 | `Accordion` | Stack of sections that open and close. |
 | `Autocomplete` | Text field with a suggestion list the caller supplies and ranks. |
 | `Avatar` | Avatar with an initials or gradient fallback. |

package/package.json

@@ -2,8 +2,8 @@
   "dependencies": {
     "@base-ui/react": "^1.8.0",
     "@cprussin/option-result": "^2.0.1",
-    "@domicile-desktop/sdk": "0.0.0-alpha-7e37a30d1bac",
-    "@domicile-desktop/system-apps": "0.0.0-alpha-7e37a30d1bac",
+    "@domicile-desktop/sdk": "0.0.0-alpha-617f1cc7ddbb",
+    "@domicile-desktop/system-apps": "0.0.0-alpha-617f1cc7ddbb",
     "@pandacss/dev": "^1.12.1",
     "@phosphor-icons/react": "^2.1.10"
   },
@@ -33,6 +33,7 @@
     "./AppChooser": "./src/AppChooser/AppChooser.tsx",
     "./Autocomplete": "./src/Autocomplete/Autocomplete.tsx",
     "./Avatar": "./src/Avatar/Avatar.tsx",
+    "./app-host-frames": "./src/app-host-frames.ts",
     "./appearance": "./src/ThemeSwitch/appearance.ts",
     "./Button": "./src/Button/Button.tsx",
     "./Card": "./src/Card/Card.tsx",
@@ -108,5 +109,5 @@
     "test:unit": "bun test"
   },
   "type": "module",
-  "version": "0.0.0-alpha-7e37a30d1bac"
+  "version": "0.0.0-alpha-617f1cc7ddbb"
 }

package/src/app-host-frames.ts

@@ -0,0 +1,55 @@
+// The framing of `domicile-app-host`, the process app modules spawn, on its
+// stdin and stdout: each message is a 4-byte little-endian length, then that
+// many bytes of UTF-8 JSON.
+
+/** The bytes of the length before each message. */
+const LENGTH_BYTES = 4;
+
+/** `message` as one frame. */
+export const encodeFrame = (message: unknown): Uint8Array => {
+  const body = new TextEncoder().encode(JSON.stringify(message));
+  const frame = new Uint8Array(LENGTH_BYTES + body.length);
+  new DataView(frame.buffer).setUint32(0, body.length, true);
+  frame.set(body, LENGTH_BYTES);
+  return frame;
+};
+
+/**
+ * A decoder for a stream of frames that arrive in chunks of any size. Each
+ * call takes the next chunk and returns the messages it completed, parsed
+ * from JSON.
+ */
+export const frameDecoder = () => {
+  let buffered: Uint8Array = new Uint8Array();
+  return (chunk: Uint8Array): unknown[] => {
+    buffered = joined(buffered, chunk);
+    const messages: unknown[] = [];
+    for (
+      let length = lengthOf(buffered);
+      length !== undefined && buffered.length >= LENGTH_BYTES + length;
+      length = lengthOf(buffered)
+    ) {
+      const body = buffered.subarray(LENGTH_BYTES, LENGTH_BYTES + length);
+      messages.push(JSON.parse(new TextDecoder().decode(body)));
+      buffered = buffered.slice(LENGTH_BYTES + length);
+    }
+    return messages;
+  };
+};
+
+/** The length `buffered` starts with, or `undefined` before all of it came. */
+const lengthOf = (buffered: Uint8Array): number | undefined =>
+  buffered.length < LENGTH_BYTES
+    ? undefined
+    : new DataView(
+        buffered.buffer,
+        buffered.byteOffset,
+        LENGTH_BYTES,
+      ).getUint32(0, true);
+
+const joined = (first: Uint8Array, second: Uint8Array): Uint8Array => {
+  const both = new Uint8Array(first.length + second.length);
+  both.set(first);
+  both.set(second, first.length);
+  return both;
+};