@pocketcoder/shared 0.0.2

package/src/types/relay.ts

@@ -0,0 +1,79 @@
+/**
+ * Relay-specific types shared between relay, daemon, and client.
+ * Covers connection state, authentication handshake, and daemon status messages.
+ *
+ * See PRD.md: "Client Handshake Flow", "Daemon Registration", and "Connection Status" sections.
+ */
+
+import type { MessageError } from "./messages.js";
+
+// ---------------------------------------------------------------------------
+// Connection types
+// ---------------------------------------------------------------------------
+
+/**
+ * Represents a connected daemon's state in the relay.
+ * Registry key: `${userId}:${machineKey}`
+ *
+ * The `ws` field is typed as `unknown` since the shared package doesn't
+ * depend on the `ws` library. The relay casts it to `WebSocket` at runtime.
+ */
+export interface DaemonConnection {
+  ws: unknown;
+  userId: string;
+  machineKey: string;
+  projects: Set<string>;
+  connectedAt: Date;
+  lastPongAt: Date;
+}
+
+// ---------------------------------------------------------------------------
+// client_auth (Client → Relay → Client)
+// ---------------------------------------------------------------------------
+
+/** Client sends to authenticate on connect */
+export interface ClientAuthMessage {
+  type: "client_auth";
+  payload: {
+    token: string;
+  };
+}
+
+/** Relay responds with auth result */
+export interface ClientAuthResponse {
+  type: "client_auth_response";
+  payload: {
+    userId?: string;
+    authenticated: boolean;
+  };
+  error?: MessageError;
+}
+
+// ---------------------------------------------------------------------------
+// daemon_status (Relay → Client, push message)
+// ---------------------------------------------------------------------------
+
+/** Relay pushes to clients when a daemon connects or disconnects */
+export interface DaemonStatusMessage {
+  type: "daemon_status";
+  payload: {
+    machineKey: string;
+    connected: boolean;
+    lastSeen?: string; // ISO 8601
+  };
+}
+
+/**
+ * Initial daemon status pushed after client_auth, containing all user's machines.
+ * Uses `machines` array format instead of single machine.
+ */
+export interface DaemonStatusBatchMessage {
+  type: "daemon_status";
+  payload: {
+    machines: Array<{
+      machineKey: string;
+      connected: boolean;
+      lastSeen?: string;
+    }>;
+  };
+}