@jamiexiongr/panda 0.0.0-fallback-test-2

package/README.md

@@ -0,0 +1,40 @@
+# @jamiexiongr/panda
+
+Combined installer and CLI entry for Panda.
+
+This package is intended for end users who want to run Panda on their own machine and open it from a phone over Tailscale.
+
+## Requirements
+
+- Node.js `>= 20.19.0`
+- A desktop installation of Tailscale with CLI access
+- Your computer and phone joined to the same tailnet
+- Recommended mobile browsers:
+  iPhone / iPad with Safari 16.4+;
+  Android with a current Chrome stable release
+
+For the complete Chinese install and usage guide in this repository, see `docs/panda-user-guide.md`.
+
+## Install
+
+```bash
+npm install -g @jamiexiongr/panda@latest --registry=https://registry.npmjs.org/
+```
+
+## Usage
+
+```bash
+panda hub
+panda hub tailscareserv
+
+panda agent
+panda agent tailscareserv
+```
+
+`tailscareserv` and `--tailscale-serve` both enable automatic `tailscale serve` publishing.
+
+## Notes
+
+- `panda hub tailscareserv` is the quickest path to a mobile-installable HTTPS PWA inside your tailnet.
+- `panda agent tailscareserv` makes the agent register `https/wss` direct URLs when no explicit direct URL env vars are set.
+- If `tailscale serve` says it is not enabled on your tailnet, open the approval link printed by the CLI and enable Serve for that node.

package/bin/panda.cjs

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

package/dist/cli.mjs

@@ -0,0 +1,166 @@
+// packages/provider-codex/src/tailscale.ts
+import { execFileSync } from "child_process";
+var ENABLED_ARGS = /* @__PURE__ */ new Set([
+  "tailscareserv",
+  "--tailscareserv",
+  "tailscale-serve",
+  "--tailscale-serve"
+]);
+var PUBLIC_ARGS = /* @__PURE__ */ new Set([
+  "tailscareserv-pub",
+  "--tailscareserv-pub",
+  "tailscale-serve-pub",
+  "--tailscale-serve-pub",
+  "tailscalefunnel",
+  "--tailscalefunnel",
+  "tailscale-funnel",
+  "--tailscale-funnel"
+]);
+var DISABLED_ARGS = /* @__PURE__ */ new Set([
+  "no-tailscareserv",
+  "--no-tailscareserv",
+  "no-tailscale-serve",
+  "--no-tailscale-serve",
+  "no-tailscareserv-pub",
+  "--no-tailscareserv-pub",
+  "no-tailscale-serve-pub",
+  "--no-tailscale-serve-pub",
+  "no-tailscalefunnel",
+  "--no-tailscalefunnel",
+  "no-tailscale-funnel",
+  "--no-tailscale-funnel"
+]);
+var trimToNull = (value) => {
+  const normalized = value?.trim() ?? "";
+  return normalized ? normalized : null;
+};
+var parseBooleanLike = (value) => {
+  const normalized = trimToNull(value)?.toLowerCase();
+  if (!normalized) {
+    return null;
+  }
+  if (["1", "true", "yes", "on"].includes(normalized)) {
+    return true;
+  }
+  if (["0", "false", "no", "off"].includes(normalized)) {
+    return false;
+  }
+  return null;
+};
+var parsePublicationModeLike = (value) => {
+  const normalized = trimToNull(value)?.toLowerCase();
+  if (!normalized) {
+    return null;
+  }
+  if (["serve", "private", "tailnet"].includes(normalized)) {
+    return "serve";
+  }
+  if (["funnel", "public", "pub"].includes(normalized)) {
+    return "funnel";
+  }
+  if (["disabled", "none", "off"].includes(normalized)) {
+    return "disabled";
+  }
+  return null;
+};
+var resolveTailscalePublicationMode = (options) => {
+  const argv = options?.argv ?? [];
+  for (const candidate of argv) {
+    const normalized = candidate.trim().toLowerCase();
+    if (PUBLIC_ARGS.has(normalized)) {
+      return "funnel";
+    }
+    if (ENABLED_ARGS.has(normalized)) {
+      return "serve";
+    }
+    if (DISABLED_ARGS.has(normalized)) {
+      return "disabled";
+    }
+  }
+  const env = options?.env ?? process.env;
+  const scopedMode = options?.envPrefix ? parsePublicationModeLike(env[`${options.envPrefix}_TAILSCALE_PUBLISH_MODE`]) : null;
+  if (scopedMode) {
+    return scopedMode;
+  }
+  const genericMode = parsePublicationModeLike(env.PANDA_TAILSCALE_PUBLISH_MODE);
+  if (genericMode) {
+    return genericMode;
+  }
+  const scopedEnabled = options?.envPrefix ? parseBooleanLike(env[`${options.envPrefix}_TAILSCALE_SERVE`]) : null;
+  if (scopedEnabled !== null) {
+    return scopedEnabled ? "serve" : "disabled";
+  }
+  const envEnabled = parseBooleanLike(env.PANDA_TAILSCALE_SERVE);
+  if (envEnabled !== null) {
+    return envEnabled ? "serve" : "disabled";
+  }
+  return "disabled";
+};
+
+// release/panda/src/cli.ts
+var printUsage = () => {
+  console.log(`panda <command>
+
+Commands:
+  agent [tailscareserv|tailscareserv-pub] [--hub-url=<url>]    Start the Panda agent service
+  hub [tailscareserv|tailscareserv-pub]      Start the Panda hub service with the bundled web UI
+  help     Show this message`);
+};
+var resolveCliOptionValue = (argv, aliases) => {
+  for (let index = 0; index < argv.length; index += 1) {
+    const candidate = argv[index]?.trim() ?? "";
+    const normalized = candidate.toLowerCase();
+    for (const alias of aliases) {
+      if (normalized === alias) {
+        return argv[index + 1]?.trim() || null;
+      }
+      if (normalized.startsWith(`${alias}=`)) {
+        return candidate.slice(alias.length + 1).trim() || null;
+      }
+    }
+  }
+  return null;
+};
+var main = async () => {
+  const command = process.argv[2]?.trim().toLowerCase() ?? "help";
+  const commandArgs = process.argv.slice(3);
+  const agentPublicationMode = resolveTailscalePublicationMode({
+    argv: commandArgs,
+    envPrefix: "PANDA_AGENT"
+  });
+  const hubPublicationMode = resolveTailscalePublicationMode({
+    argv: commandArgs,
+    envPrefix: "PANDA_HUB"
+  });
+  if (command === "help" || command === "--help" || command === "-h") {
+    printUsage();
+    return;
+  }
+  if (command === "agent") {
+    const { startJamiexiongrAgent } = await import("@jamiexiongr/panda-agent");
+    await startJamiexiongrAgent({
+      tailscalePublicationMode: agentPublicationMode,
+      hubUrl: resolveCliOptionValue(commandArgs, [
+        "hub",
+        "--hub",
+        "hub-url",
+        "--hub-url",
+        "huburl",
+        "--huburl"
+      ]),
+      argv: commandArgs
+    });
+    return;
+  }
+  if (command === "hub") {
+    const { startJamiexiongrHub } = await import("@jamiexiongr/panda-hub");
+    await startJamiexiongrHub({
+      tailscalePublicationMode: hubPublicationMode
+    });
+    return;
+  }
+  console.error(`Unknown command: ${command}`);
+  printUsage();
+  process.exitCode = 1;
+};
+void main();

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@jamiexiongr/panda",
+  "version": "0.0.0-fallback-test-2",
+  "type": "module",
+  "private": false,
+  "description": "Panda combined installer",
+  "bin": {
+    "panda": "./bin/panda.cjs"
+  },
+  "dependencies": {
+    "@jamiexiongr/panda-agent": "0.0.0-fallback-test-2",
+    "@jamiexiongr/panda-hub": "0.0.0-fallback-test-2"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  }
+}