@ganglion/xacpx-relay 0.1.0

package/README.md

@@ -0,0 +1,10 @@
+# @ganglion/xacpx-relay
+
+Self-hosted relay hub for xacpx. Multiple xacpx instances dial out to this
+server over WebSocket; accounts log in over HTTP to manage and drive them.
+
+Runtime: Node >= 22.13 (uses node:sqlite) or Bun >= 1.2 (uses bun:sqlite).
+Two ports: HTTP API (default 8787) and instance WebSocket gateway (default 8788).
+
+See `docs/relay-module.md` and the design spec
+`docs/superpowers/specs/2026-06-13-relay-hub-design.md` in the repo root.

package/dist/auth.d.ts

@@ -0,0 +1,6 @@
+/** 32 random bytes, base64url — used for login tokens, pairing tokens, credentials, web sessions. */
+export declare function generateToken(): string;
+/** Tokens are stored hashed at rest; sha256 suffices for high-entropy random tokens. */
+export declare function hashToken(token: string): string;
+/** Constant-time comparison of two equal-length hex hash strings. */
+export declare function hashEquals(a: string, b: string): boolean;

package/dist/cli.d.ts

@@ -0,0 +1,24 @@
+export interface RelayCliIo {
+    print(line: string): void;
+}
+/** Fixed absolute default DB path — independent of cwd so `add token` and `start` always hit the same DB. */
+export declare function defaultDbPath(): string;
+/**
+ * Locates the bundled relay-web dashboard relative to the compiled cli.js.
+ * Returns the path only if `index.html` is present there; otherwise undefined.
+ * Defensive: returns undefined if process.argv[1] is not set.
+ */
+export declare function resolveBundledWebRoot(): string | undefined;
+export interface StartOptions {
+    dbPath: string;
+    httpPort: number;
+    wsPort: number;
+    host: string | undefined;
+    webRoot: string | undefined;
+    historyRetentionDays: number | undefined;
+    requestTimeoutMs: number | undefined;
+    trustProxy: boolean;
+}
+/** Pure arg-parser for the `start` subcommand — testable without starting a server. */
+export declare function parseStartOptions(args: string[]): StartOptions;
+export declare function runRelayCli(args: string[], io: RelayCliIo): Promise<number>;