@jamiexiongr/panda-hub 0.1.0 → 0.1.2

package/README.md

@@ -1,3 +1,32 @@
 # @jamiexiongr/panda-hub
 
 Published hub runtime for Panda, including the built web UI.
+
+## Usage
+
+```bash
+panda-hub
+panda-hub tailscareserv
+```
+
+`tailscareserv` and `--tailscale-serve` both enable automatic `tailscale serve` publishing.
+
+When enabled, hub startup will:
+
+- detect whether `tailscale` is available and online
+- run `tailscale serve --bg`
+- print the generated Tailscale HTTPS URL in the startup log
+
+## Environment
+
+- `PANDA_HUB_PORT`
+  Local hub listen port. Default: `4343`
+- `PANDA_HUB_TAILSCALE_SERVE_PORT`
+  Tailscale HTTPS port. Default: `443`
+- `PANDA_TAILSCALE_SERVE=1`
+  Optional env alternative to the startup flag
+
+## Notes
+
+- Tailscale Serve publishes a tailnet HTTPS address, not a public Internet address.
+- This is the recommended way to run the installable PWA on mobile, because the bundled hub serves the built web assets over HTTPS.

package/bin/panda-hub.cjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import('../dist/cli.mjs')

package/dist/chunk-CS7XM33H.mjs

@@ -0,0 +1,89 @@
+import {
+  configureTailscaleServe,
+  ensurePandaHubApiKey,
+  printTerminalQr,
+  resolveTailscaleServeEnabled,
+  resolveTailscaleServePort,
+  startPandaSessionService
+} from "./chunk-GPLVIR3L.mjs";
+
+// release/panda-hub/src/index.ts
+import path from "path";
+import { fileURLToPath } from "url";
+
+// release/panda-hub/package.json
+var package_default = {
+  name: "@jamiexiongr/panda-hub",
+  version: "0.1.2",
+  type: "module",
+  private: false,
+  description: "Panda hub runtime",
+  dependencies: {
+    "@fastify/cors": "^10.0.2",
+    "@fastify/websocket": "^11.0.2",
+    fastify: "^5.2.1"
+  },
+  bin: {
+    "panda-hub": "./bin/panda-hub.cjs"
+  },
+  exports: {
+    ".": "./dist/index.mjs"
+  },
+  files: [
+    "bin",
+    "dist"
+  ],
+  publishConfig: {
+    access: "public",
+    registry: "https://registry.npmjs.org/"
+  },
+  engines: {
+    node: ">=20.19.0"
+  }
+};
+
+// release/panda-hub/src/index.ts
+var currentDirectory = path.dirname(fileURLToPath(import.meta.url));
+var startJamiexiongrHub = async (options) => {
+  const port = Number(process.env.PANDA_HUB_PORT ?? 4343);
+  const tailscaleServe = configureTailscaleServe({
+    enabled: options?.tailscaleServe ?? resolveTailscaleServeEnabled(),
+    serviceName: "panda-hub",
+    localPort: port,
+    servePort: resolveTailscaleServePort({
+      envPrefix: "PANDA_HUB",
+      defaultPort: 443
+    }),
+    logger: console
+  });
+  const hubApiKey = await ensurePandaHubApiKey({
+    configuredApiKey: process.env.PANDA_HUB_API_KEY ?? null,
+    codexHome: process.env.PANDA_CODEX_HOME ?? null,
+    logger: console
+  });
+  if (hubApiKey.apiKey) {
+    process.env.PANDA_HUB_API_KEY = hubApiKey.apiKey;
+  }
+  const webUiDir = path.resolve(currentDirectory, "../web");
+  const app = await startPandaSessionService({
+    serviceName: "panda-hub",
+    mode: "hub",
+    port,
+    transport: "hub-routed",
+    version: package_default.version,
+    webUiDir
+  });
+  if (tailscaleServe.active && tailscaleServe.baseUrl) {
+    console.info(`Panda hub Tailscale HTTPS URL: ${tailscaleServe.baseUrl}`);
+    console.info(`Agent hub URL env: PANDA_HUB_URL=${tailscaleServe.baseUrl}`);
+    printTerminalQr(tailscaleServe.baseUrl, {
+      logger: console,
+      label: "Scan this QR code to open Panda hub on your phone:"
+    });
+  }
+  return app;
+};
+
+export {
+  startJamiexiongrHub
+};