@dev-anywhere/relay 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 catli
+
+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,71 @@
+# @dev-anywhere/relay
+
+Relay server for [`@dev-anywhere/proxy`](https://www.npmjs.com/package/@dev-anywhere/proxy) — bridges local AI CLI proxies to remote web clients via WebSocket.
+
+## Install
+
+```bash
+npm install -g @dev-anywhere/relay
+```
+
+This installs the `dev-anywhere-relay` command globally.
+
+Requires Node.js >= 20.
+
+## Quick start
+
+```bash
+# Minimal, plaintext WS on port 3100:
+PORT=3100 dev-anywhere-relay
+
+# With auth tokens (recommended for any public relay):
+RELAY_PROXY_TOKEN="$(openssl rand -hex 24)" \
+RELAY_CLIENT_TOKEN="$(openssl rand -hex 24)" \
+PORT=3100 dev-anywhere-relay
+```
+
+## Endpoints
+
+| Path      | Purpose                                 |
+| --------- | --------------------------------------- |
+| `/health` | HTTP GET — health probe                 |
+| `/status` | HTTP GET — proxy/client counts          |
+| `/proxy`  | WS — proxy daemon connection            |
+| `/client` | WS — web SPA / mobile client connection |
+
+## Environment variables
+
+| Variable             | Default                         | Notes                                              |
+| -------------------- | ------------------------------- | -------------------------------------------------- |
+| `PORT`               | `3100`                          | HTTP + WSS listen port                             |
+| `DATA_DIR`           | `~/.dev-anywhere/relay-data`    | Persistent state. Set to empty string to disable.  |
+| `HEARTBEAT_INTERVAL` | `30000` (ms)                    | WS ping cadence                                    |
+| `RELAY_PROXY_TOKEN`  | unset (open `/proxy` endpoint)  | When set, `/proxy` rejects connections without it  |
+| `RELAY_CLIENT_TOKEN` | unset (open `/client` endpoint) | When set, `/client` rejects connections without it |
+| `LOG_LEVEL`          | `info`                          | pino log level                                     |
+
+**Production warning:** always set both `RELAY_PROXY_TOKEN` and `RELAY_CLIENT_TOKEN`. Without a client token, anyone who can reach the relay can connect to `/client`, list proxies, and attempt to bind to a proxy.
+
+For the bundled web client, open the app once with `?relayToken=<RELAY_CLIENT_TOKEN>` in the page URL. The token is stored in `sessionStorage` for that browser tab and appended to `/client` WebSocket connections.
+
+## TLS
+
+This package serves plain HTTP + WS. For production, put it behind nginx / Caddy / Cloudflare with a TLS termination. One-liner turnkey setup (docker compose + nginx + certbot) is available via `install-relay.sh` in the [repo](https://github.com/lichenxicatapple-blip/dev-anywhere).
+
+## Using the embedded server programmatically
+
+```ts
+import { createRelayServer } from "@dev-anywhere/relay/server";
+import pino from "pino";
+
+const relay = createRelayServer({
+  port: 3100,
+  logger: pino(),
+  proxyToken: process.env.RELAY_PROXY_TOKEN,
+  clientToken: process.env.RELAY_CLIENT_TOKEN,
+});
+```
+
+## License
+
+MIT © catli

package/dist/chaos.d.ts

@@ -0,0 +1,22 @@
+import { WebSocket } from "ws";
+import type { Logger } from "@dev-anywhere/shared";
+export type RelayChaosDirection = "client_to_proxy" | "proxy_to_client";
+export interface RelayChaosOptions {
+    enabled: boolean;
+    delayMs: number;
+    duplicate: boolean;
+    duplicateDelayMs: number;
+    reorder: boolean;
+    reorderDelayMs: number;
+    types: Set<string> | undefined;
+}
+export interface RelayChaosMeta {
+    direction: RelayChaosDirection;
+    type: string;
+}
+export interface RelayChaos {
+    send(ws: WebSocket, data: string | Buffer, meta: RelayChaosMeta): void;
+}
+export declare function parseRelayChaosFromEnv(env: NodeJS.ProcessEnv): RelayChaosOptions;
+export declare function createRelayChaos(options: RelayChaosOptions, logger: Logger): RelayChaos;
+//# sourceMappingURL=chaos.d.ts.map

package/dist/chaos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chaos.d.ts","sourceRoot":"","sources":["../src/chaos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;CACxE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,iBAAiB,CAehF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAsCvF"}