@0xmaxma/claude-gateway 1.7.10 → 1.8.0

package/dist/cli/commands/gateway.js

@@ -0,0 +1,145 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGatewayLifecycle = runGatewayLifecycle;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const http_client_1 = require("../http-client");
+const health_1 = require("../health");
+const manager_1 = require("../manager");
+const output_1 = require("../output");
+const output_2 = require("../output");
+/**
+ * `gateway start|status|restart|stop` — whole-process lifecycle.
+ *
+ * `start` is handled by the boot entry point (src/index.ts), which recognises
+ * it before the CLI is ever imported; it is listed here only so the usage text
+ * and an unknown-verb error stay honest. Restart/stop must be performed by
+ * whatever manager owns the process (it has to stop the very process serving
+ * HTTP), so detection resolves the manager and the action is delegated to it.
+ */
+async function runGatewayLifecycle(positionals, flags, config) {
+    const verb = positionals[0];
+    if (!verb) {
+        // `gateway --help` is a help request (0); a bare `gateway` is a usage error (1).
+        (0, output_2.writeCommandHelp)(flags.help === true, 'gateway', 'manage the gateway process on this host', 'claude-gateway gateway <start|status|restart|stop>', ['  start is the only command that boots a server; the rest are manager-aware.']);
+        return flags.help === true ? 0 : 1;
+    }
+    switch (verb) {
+        case 'start':
+            // Only reachable when runCli() is called directly (tests, embedding) —
+            // the installed binary routes `gateway start` straight into the server.
+            process.stderr.write('`gateway start` is handled by the claude-gateway entry point, not the CLI runner.\n');
+            return 1;
+        case 'status':
+            return gatewayStatus(flags, config);
+        case 'restart':
+            return gatewayAction('restart');
+        case 'stop':
+            return gatewayAction('stop');
+        default:
+            process.stderr.write(`Unknown: gateway ${verb} (expected start|status|restart|stop)\n`);
+            return 1;
+    }
+}
+async function gatewayStatus(flags, config) {
+    const manager = (0, manager_1.detectManager)();
+    // `manager` describes the process on this host, so `health` must too:
+    // probing config.publicUrl would report a reverse proxy (possibly fronting a
+    // different instance) rather than the gateway this command just detected.
+    const baseUrl = (0, http_client_1.resolveLocalUrl)({ flagUrl: typeof flags.url === 'string' ? flags.url : undefined, env: process.env, config });
+    // `detail` carries what `health` cannot: an address answering 401 or 500 is
+    // not the same failure as one answering nothing, and collapsing both into
+    // "down" throws away the only clue about which one it is.
+    const probe = await (0, health_1.probeHealth)(baseUrl);
+    (0, output_1.printJson)({ manager, url: baseUrl, health: probe.ok ? 'up' : 'down', detail: probe.detail }, flags);
+    return probe.ok ? 0 : 1;
+}
+function gatewayAction(action) {
+    const manager = (0, manager_1.detectManager)();
+    try {
+        switch (manager) {
+            case 'systemd-user':
+                (0, child_process_1.execFileSync)('systemctl', ['--user', action, 'claude-gateway.service'], { stdio: 'inherit' });
+                return Promise.resolve(0);
+            case 'systemd-system': {
+                // A system-scoped unit needs root; announce the escalation instead of
+                // silently invoking sudo, and skip it entirely when already root.
+                const needsSudo = typeof process.getuid === 'function' && process.getuid() !== 0;
+                if (needsSudo) {
+                    process.stderr.write(`Using the system service (may require sudo): systemctl ${action} claude-gateway.service\n`);
+                    (0, child_process_1.execFileSync)('sudo', ['systemctl', action, 'claude-gateway.service'], { stdio: 'inherit' });
+                }
+                else {
+                    (0, child_process_1.execFileSync)('systemctl', [action, 'claude-gateway.service'], { stdio: 'inherit' });
+                }
+                return Promise.resolve(0);
+            }
+            case 'pm2':
+                (0, child_process_1.execFileSync)('pm2', [action, 'gateway'], { stdio: 'inherit' });
+                return Promise.resolve(0);
+            case 'foreground': {
+                const pid = parseInt(fs.readFileSync((0, manager_1.defaultPidfilePath)(), 'utf8').trim(), 10);
+                // The pidfile only proves some process holds this pid. A gateway lost
+                // to SIGKILL or the OOM killer leaves the file behind, and once the pid
+                // is recycled this branch would SIGTERM an unrelated process and report
+                // success. Confirm it is a gateway before signalling it.
+                if (!(0, manager_1.pidLooksLikeGateway)(pid)) {
+                    process.stderr.write(`Pidfile names pid ${pid}, but that process does not look like a gateway — refusing to signal it. ` +
+                        `The gateway likely died without cleaning up; remove ${(0, manager_1.defaultPidfilePath)()} if it is stale.\n`);
+                    return Promise.resolve(1);
+                }
+                process.kill(pid, 'SIGTERM');
+                if (action === 'restart') {
+                    process.stderr.write('Stopped the foreground gateway (SIGTERM) but a bare foreground process has no supervisor to respawn it — ' +
+                        'start it again with `claude-gateway gateway start`, or install a service with `claude-gateway service install`.\n');
+                    // Only the "stop" half of restart happened — a caller/script checking
+                    // the exit code should see this as incomplete, not a successful restart.
+                    return Promise.resolve(1);
+                }
+                process.stderr.write(`Sent SIGTERM to gateway (pid ${pid}).\n`);
+                return Promise.resolve(0);
+            }
+            default:
+                process.stderr.write('Could not detect how the gateway is running (systemd-user/systemd-system/pm2/foreground). Nothing done.\n');
+                return Promise.resolve(1);
+        }
+    }
+    catch (err) {
+        process.stderr.write(`gateway ${action} failed: ${err.message}\n`);
+        return Promise.resolve(1);
+    }
+}
+//# sourceMappingURL=gateway.js.map

package/dist/cli/commands/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../../src/cli/commands/gateway.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/service.d.ts

@@ -0,0 +1,33 @@
+import { CliConfigView } from '../http-client';
+export type ServiceManager = 'systemd' | 'pm2';
+export interface LaunchSpec {
+    node: string;
+    entry: string;
+    cwd: string;
+    config: string;
+    home: string;
+    pathEnv: string;
+}
+/**
+ * Build the PATH the service will run with.
+ *
+ * The inherited PATH is not usable: an interactive shell's PATH is full of
+ * session-scoped entries (editor servers, per-project node_modules/.bin) that
+ * may not exist when systemd starts the unit at boot. Instead, pin the
+ * directories the gateway actually needs — the node that will run it, the
+ * `claude` binary it spawns, and the standard system paths — keeping only
+ * those that exist.
+ */
+export declare function servicePath(): string;
+/** Resolve the absolute launch triple (node, entry, cwd) for a generated unit.
+ *  Returns null — with a message — when the entry point can't be located, so a
+ *  broken install never produces a unit that silently fails at boot. */
+export declare function resolveLaunchSpec(flags: Record<string, string | boolean>): LaunchSpec | null;
+/** Pure renderer — exported so `--print` and the tests see the exact bytes that
+ *  would be written to disk. */
+export declare function renderSystemdUnit(spec: LaunchSpec): string;
+/** The exact argv `service install --manager pm2` would run. Exported for
+ *  `--print` and tests so the preview can never drift from the real call. */
+export declare function pm2StartArgs(spec: LaunchSpec): string[];
+export declare function runService(positionals: string[], flags: Record<string, string | boolean>, config?: CliConfigView): Promise<number>;
+//# sourceMappingURL=service.d.ts.map

package/dist/cli/commands/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/service.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAmB,MAAM,gBAAgB,CAAC;AA0BhE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,KAAK,CAAC;AAG/C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAWD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAoBpC;AAYD;;wEAEwE;AACxE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,UAAU,GAAG,IAAI,CAwB5F;AAQD;gCACgC;AAChC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAwB1D;AAED;6EAC6E;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAevD;AAgUD,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EACvC,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,CAiCjB"}