@lmnr-ai/claude-code-proxy 0.1.10 → 0.1.12

package/dist/index.d.ts

@@ -67,8 +67,11 @@ export declare class ProxyServer {
     runServer(url: string): void;
     /**
      * Stop the proxy server and its health monitoring.
+     *
+     * @param timeout - Maximum time in seconds to wait for graceful shutdown (default: 4).
+     *                  The server will abort pending connections and background tasks after timeout/2.
      */
-    stopServer(): void;
+    stopServer(timeout?: number): void;
     /**
      * Check if the server is currently running.
      */
@@ -96,8 +99,11 @@ export declare function runServer(url: string, port?: number): void;
  *
  * This is a backwards-compatible function that uses a global singleton instance.
  * For more control, consider creating your own ProxyServer instance.
+ *
+ * @param timeout - Maximum time in seconds to wait for graceful shutdown (default: 4).
+ *                  The server will abort pending connections and background tasks after timeout/2.
  */
-export declare function stopServer(): void;
+export declare function stopServer(timeout?: number): void;
 /**
  * Set the current trace context by sending an HTTP request to the running proxy server.
  *
@@ -108,4 +114,4 @@ export declare function stopServer(): void;
  * @throws Error if the HTTP request fails
  */
 export declare function setCurrentTrace(context: SpanContext): Promise<void>;
-export declare const run: any, stop: any;
+export declare const run: any, stop: any, stopWithTimeout: any;

package/dist/index.js

@@ -3,7 +3,7 @@
  * Laminar Claude Code Proxy - TypeScript/JavaScript bindings for HTTP proxy server
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stop = exports.run = exports.ProxyServer = void 0;
+exports.stopWithTimeout = exports.stop = exports.run = exports.ProxyServer = void 0;
 exports.runServer = runServer;
 exports.stopServer = stopServer;
 exports.setCurrentTrace = setCurrentTrace;
@@ -148,7 +148,7 @@ class ProxyServer {
                 try {
                     // Try to stop the existing server (it might be stuck)
                     try {
-                        native.stop(this.port);
+                        native.stopWithTimeout(this.port, 4);
                     }
                     catch {
                         // Server might already be dead
@@ -198,12 +198,14 @@ class ProxyServer {
         this.monitorInterval = setInterval(() => {
             this.healthCheckMonitor().catch(() => { });
         }, HEALTH_CHECK_INTERVAL);
-        console.info(`Started proxy server with health monitoring on port ${this.port}`);
     }
     /**
      * Stop the proxy server and its health monitoring.
+     *
+     * @param timeout - Maximum time in seconds to wait for graceful shutdown (default: 4).
+     *                  The server will abort pending connections and background tasks after timeout/2.
      */
-    stopServer() {
+    stopServer(timeout = 4) {
         // Stop the monitor
         if (this.monitorInterval !== null) {
             clearInterval(this.monitorInterval);
@@ -211,15 +213,11 @@ class ProxyServer {
         }
         // Reset the health check flag
         this.isHealthCheckRunning = false;
-        // Stop the server
-        try {
-            native.stop(this.port);
-            this._isRunning = false;
-        }
-        catch (error) {
-            console.debug(`Error stopping the proxy server on port ${this.port}: ${error}`);
-        }
-        console.debug(`Stopped proxy server and health monitoring on port ${this.port}`);
+        // Once we stop monitoring, we've lost active management of the server,
+        // so we mark it as not running regardless of shutdown success
+        this._isRunning = false;
+        // Stop the server and re-throw any errors to inform caller
+        native.stopWithTimeout(this.port, timeout);
     }
     /**
      * Check if the server is currently running.
@@ -273,9 +271,12 @@ function runServer(url, port = 45667) {
  *
  * This is a backwards-compatible function that uses a global singleton instance.
  * For more control, consider creating your own ProxyServer instance.
+ *
+ * @param timeout - Maximum time in seconds to wait for graceful shutdown (default: 4).
+ *                  The server will abort pending connections and background tasks after timeout/2.
  */
-function stopServer() {
-    getGlobalProxy().stopServer();
+function stopServer(timeout = 4) {
+    getGlobalProxy().stopServer(timeout);
 }
 /**
  * Set the current trace context by sending an HTTP request to the running proxy server.
@@ -290,4 +291,4 @@ async function setCurrentTrace(context) {
     return getGlobalProxy().setCurrentTrace(context);
 }
 // Re-export native functions for direct access if needed
-exports.run = native.run, exports.stop = native.stop;
+exports.run = native.run, exports.stop = native.stop, exports.stopWithTimeout = native.stopWithTimeout;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lmnr-ai/claude-code-proxy",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "HTTP proxy for Claude Desktop API requests with Laminar observability",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -23,13 +23,13 @@
     "dist"
   ],
   "optionalDependencies": {
-    "@lmnr-ai/claude-code-proxy-darwin-arm64": "0.1.10",
-    "@lmnr-ai/claude-code-proxy-darwin-x64": "0.1.10",
-    "@lmnr-ai/claude-code-proxy-win32-x64-msvc": "0.1.10",
-    "@lmnr-ai/claude-code-proxy-linux-x64-gnu": "0.1.10",
-    "@lmnr-ai/claude-code-proxy-linux-arm64-gnu": "0.1.10",
-    "@lmnr-ai/claude-code-proxy-linux-x64-musl": "0.1.10",
-    "@lmnr-ai/claude-code-proxy-linux-arm64-musl": "0.1.10"
+    "@lmnr-ai/claude-code-proxy-darwin-arm64": "0.1.12",
+    "@lmnr-ai/claude-code-proxy-darwin-x64": "0.1.12",
+    "@lmnr-ai/claude-code-proxy-win32-x64-msvc": "0.1.12",
+    "@lmnr-ai/claude-code-proxy-linux-x64-gnu": "0.1.12",
+    "@lmnr-ai/claude-code-proxy-linux-arm64-gnu": "0.1.12",
+    "@lmnr-ai/claude-code-proxy-linux-x64-musl": "0.1.12",
+    "@lmnr-ai/claude-code-proxy-linux-arm64-musl": "0.1.12"
   },
   "keywords": [
     "claude",