@vibecook/ghosttea 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 James Yong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# @vibecook/ghosttea
+
+Typed browser client for connecting an Electron renderer to the Ghosttea
+terminal service through a transferred control `MessagePort`.
+
+```ts
+import { ControlClient } from "@vibecook/ghosttea";
+
+const client = new ControlClient(controlPort);
+const response = await client.request({ type: "list-sessions" });
+```
+
+Ghosttea is developed at <https://github.com/jamesyong-42/ghosttea>.

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import type { ClientCommand, ServerEvent } from "@vibecook/ghosttea-protocol";
+type CommandPayload = ClientCommand extends infer Command ? Command extends {
+    requestId: number;
+} ? Omit<Command, "requestId"> : never : never;
+export declare class ControlClient extends EventTarget {
+    #private;
+    constructor(port: MessagePort);
+    request(command: CommandPayload, timeoutMs?: number): Promise<ServerEvent>;
+    notify(command: CommandPayload): void;
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG9E,KAAK,cAAc,GAAG,aAAa,SAAS,MAAM,OAAO,GACrD,OAAO,SAAS;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACnC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,GAC1B,KAAK,GACP,KAAK,CAAC;AAQV,qBAAa,aAAc,SAAQ,WAAW;;IAK5C,YAAY,IAAI,EAAE,WAAW,EAK5B;IAED,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAWzE;IAED,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAEpC;IAED,OAAO,IAAI,IAAI,CAQd;CAuBF"}

package/dist/index.js

@@ -0,0 +1,62 @@
+import { isServerEvent } from "@vibecook/ghosttea-protocol";
+export class ControlClient extends EventTarget {
+    #port;
+    #pending = new Map();
+    #nextRequestId = 1;
+    constructor(port) {
+        super();
+        this.#port = port;
+        this.#port.addEventListener("message", this.#onMessage);
+        this.#port.start();
+    }
+    request(command, timeoutMs = 10_000) {
+        const requestId = this.#nextRequestId++;
+        const envelope = { ...command, requestId };
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.#pending.delete(requestId);
+                reject(new Error(`Terminal request timed out: ${command.type}`));
+            }, timeoutMs);
+            this.#pending.set(requestId, { resolve, reject, timeout });
+            this.#port.postMessage(envelope);
+        });
+    }
+    notify(command) {
+        this.#port.postMessage({ ...command, requestId: 0 });
+    }
+    dispose() {
+        this.#port.removeEventListener("message", this.#onMessage);
+        this.#port.close();
+        for (const pending of this.#pending.values()) {
+            clearTimeout(pending.timeout);
+            pending.reject(new Error("Terminal control channel closed"));
+        }
+        this.#pending.clear();
+    }
+    #onMessage = (message) => {
+        if (!isServerEvent(message.data))
+            return;
+        const event = message.data;
+        if (event.requestId === 0) {
+            this.dispatchEvent(new CustomEvent(event.type, { detail: event }));
+            if (event.type === "bridge-error") {
+                for (const pending of this.#pending.values()) {
+                    clearTimeout(pending.timeout);
+                    pending.reject(new Error(event.message));
+                }
+                this.#pending.clear();
+            }
+            return;
+        }
+        const pending = this.#pending.get(event.requestId);
+        if (!pending)
+            return;
+        this.#pending.delete(event.requestId);
+        clearTimeout(pending.timeout);
+        if (event.type === "error")
+            pending.reject(new Error(event.message));
+        else
+            pending.resolve(event);
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAc5D,MAAM,OAAO,aAAc,SAAQ,WAAW;IACnC,KAAK,CAAc;IACnB,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IACtD,cAAc,GAAG,CAAC,CAAC;IAEnB,YAAY,IAAiB;QAC3B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACxD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,OAAO,CAAC,OAAuB,EAAE,SAAS,GAAG,MAAM;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,EAAE,GAAG,OAAO,EAAE,SAAS,EAAmB,CAAC;QAC5D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAChC,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACnE,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3D,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,OAAuB;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,OAAO;QACL,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAEQ,UAAU,GAAG,CAAC,OAA8B,EAAQ,EAAE;QAC7D,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO;QACzC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;QAC3B,IAAI,KAAK,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YACnE,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBAClC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;oBAC7C,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBAC9B,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC3C,CAAC;gBACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACxB,CAAC;YACD,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACtC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;;YAChE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC;CACH"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@vibecook/ghosttea",
+  "version": "0.1.0",
+  "description": "Typed browser client for the Ghosttea terminal service.",
+  "license": "MIT",
+  "author": "James Yong",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jamesyong-42/ghosttea.git",
+    "directory": "packages/terminal-client"
+  },
+  "homepage": "https://github.com/jamesyong-42/ghosttea#readme",
+  "bugs": {
+    "url": "https://github.com/jamesyong-42/ghosttea/issues"
+  },
+  "keywords": [
+    "electron",
+    "ghostty",
+    "terminal"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@vibecook/ghosttea-protocol": "0.1.0"
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
+    "check": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "7.0.2",
+    "vitest": "4.1.10"
+  }
+}