donobu 5.38.1 → 5.39.1

package/dist/esm/main.js

@@ -116,7 +116,7 @@ const DEFAULT_PORT = 31000;
 async function startDonobuServer({ port = DEFAULT_PORT, controlPanelHost = ControlPanel_1.NoOpControlPanelFactory, environ = envVars_1.env.pick('ANTHROPIC_API_KEY', 'ANTHROPIC_MODEL_NAME', 'AWS_ACCESS_KEY_ID', 'AWS_BEDROCK_MODEL_NAME', 'AWS_SECRET_ACCESS_KEY', 'BASE64_GPT_CONFIG', 'BROWSERBASE_API_KEY', 'BROWSERBASE_PROJECT_ID', 'DONOBU_DEPLOYMENT_ENVIRONMENT', 'DONOBU_API_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'OLLAMA_API_URL', 'OLLAMA_MODEL_NAME', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY'), } = {}) {
     try {
         const adminController = await AdminApiController_1.AdminApiController.create(environ.data.DONOBU_DEPLOYMENT_ENVIRONMENT ?? 'LOCAL', controlPanelHost, environ);
-        adminController.start(port);
+        await adminController.start(port);
         Logger_1.appLogger.info(`Donobu API server available on http://localhost:${port}`);
         // Keep the process running until a process signal is detected.
         await new Promise((resolve) => {
@@ -132,8 +132,7 @@ async function startDonobuServer({ port = DEFAULT_PORT, controlPanelHost = Contr
             ['SIGTERM', 'SIGINT', 'SIGHUP'].forEach((signal) => {
                 process.on(signal, () => {
                     Logger_1.appLogger.info(`Received ${signal}, shutting down...`);
-                    adminController.stop();
-                    resolve();
+                    void adminController.stop().finally(resolve);
                 });
             });
         });

package/dist/esm/managers/AdminApiController.d.ts

@@ -62,14 +62,20 @@ export declare class AdminApiController {
     static create(donobuDeploymentEnvironment: DonobuDeploymentEnvironment, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | 'AWS_SECRET_ACCESS_KEY' | 'BASE64_GPT_CONFIG' | 'BROWSERBASE_API_KEY' | 'BROWSERBASE_PROJECT_ID' | 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'GOOGLE_GENERATIVE_AI_API_KEY' | 'GOOGLE_GENERATIVE_AI_MODEL_NAME' | 'OLLAMA_API_URL' | 'OLLAMA_MODEL_NAME' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME' | 'PERSISTENCE_PRIORITY'>): Promise<AdminApiController>;
     private constructor();
     /**
-     * Serves the API and web assets; this blocks until stop() is called.
-     * If the given port is 0, a random port is assigned.
+     * Binds the API/web-asset server to `port` and resolves once the socket is
+     * listening. If the given port is 0, a random port is assigned. Rejects on
+     * bind errors (e.g. EADDRINUSE) so callers — particularly those doing a
+     * stop/start bounce — can recover instead of crashing on an uncaught
+     * 'error' event.
      */
-    start(port: number): void;
+    start(port: number): Promise<void>;
     /**
-     * Stops the server.
+     * Stops accepting new connections and forcibly tears down any in-flight
+     * ones, then resolves. Forceful close keeps bounces predictable — a slow
+     * or stuck client request can't hold the port open. Callers that want to
+     * let in-flight work drain should do so before invoking stop().
      */
-    stop(): void;
+    stop(): Promise<void>;
     private static setupExpressFramework;
     /**
      * Sets up URL error handler middleware to catch URL parsing/decoding errors.

package/dist/esm/managers/AdminApiController.js

@@ -87,22 +87,35 @@ class AdminApiController {
         this.app = app;
     }
     /**
-     * Serves the API and web assets; this blocks until stop() is called.
-     * If the given port is 0, a random port is assigned.
+     * Binds the API/web-asset server to `port` and resolves once the socket is
+     * listening. If the given port is 0, a random port is assigned. Rejects on
+     * bind errors (e.g. EADDRINUSE) so callers — particularly those doing a
+     * stop/start bounce — can recover instead of crashing on an uncaught
+     * 'error' event.
      */
-    start(port) {
+    async start(port) {
         Logger_1.appLogger.debug(`Starting AdminController on port ${port}`);
-        this.server = this.app.listen(port);
+        await new Promise((resolve, reject) => {
+            this.server = this.app.listen(port, () => resolve());
+            this.server.once('error', reject);
+        });
     }
     /**
-     * Stops the server.
+     * Stops accepting new connections and forcibly tears down any in-flight
+     * ones, then resolves. Forceful close keeps bounces predictable — a slow
+     * or stuck client request can't hold the port open. Callers that want to
+     * let in-flight work drain should do so before invoking stop().
      */
-    stop() {
+    async stop() {
         if (this.server) {
             const address = this.server.address();
             const port = typeof address === 'string' ? address : address?.port;
             Logger_1.appLogger.debug(`Stopping AdminController on port ${port}`);
-            this.server.close();
+            const server = this.server;
+            await new Promise((resolve, reject) => {
+                server.close((err) => (err ? reject(err) : resolve()));
+                server.closeAllConnections();
+            });
         }
     }
     static async setupExpressFramework(donobuDeploymentEnvironment, controlPanelFactory, environ) {

package/dist/main.js

@@ -116,7 +116,7 @@ const DEFAULT_PORT = 31000;
 async function startDonobuServer({ port = DEFAULT_PORT, controlPanelHost = ControlPanel_1.NoOpControlPanelFactory, environ = envVars_1.env.pick('ANTHROPIC_API_KEY', 'ANTHROPIC_MODEL_NAME', 'AWS_ACCESS_KEY_ID', 'AWS_BEDROCK_MODEL_NAME', 'AWS_SECRET_ACCESS_KEY', 'BASE64_GPT_CONFIG', 'BROWSERBASE_API_KEY', 'BROWSERBASE_PROJECT_ID', 'DONOBU_DEPLOYMENT_ENVIRONMENT', 'DONOBU_API_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'OLLAMA_API_URL', 'OLLAMA_MODEL_NAME', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY'), } = {}) {
     try {
         const adminController = await AdminApiController_1.AdminApiController.create(environ.data.DONOBU_DEPLOYMENT_ENVIRONMENT ?? 'LOCAL', controlPanelHost, environ);
-        adminController.start(port);
+        await adminController.start(port);
         Logger_1.appLogger.info(`Donobu API server available on http://localhost:${port}`);
         // Keep the process running until a process signal is detected.
         await new Promise((resolve) => {
@@ -132,8 +132,7 @@ async function startDonobuServer({ port = DEFAULT_PORT, controlPanelHost = Contr
             ['SIGTERM', 'SIGINT', 'SIGHUP'].forEach((signal) => {
                 process.on(signal, () => {
                     Logger_1.appLogger.info(`Received ${signal}, shutting down...`);
-                    adminController.stop();
-                    resolve();
+                    void adminController.stop().finally(resolve);
                 });
             });
         });

package/dist/managers/AdminApiController.d.ts

@@ -62,14 +62,20 @@ export declare class AdminApiController {
     static create(donobuDeploymentEnvironment: DonobuDeploymentEnvironment, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | 'AWS_SECRET_ACCESS_KEY' | 'BASE64_GPT_CONFIG' | 'BROWSERBASE_API_KEY' | 'BROWSERBASE_PROJECT_ID' | 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'GOOGLE_GENERATIVE_AI_API_KEY' | 'GOOGLE_GENERATIVE_AI_MODEL_NAME' | 'OLLAMA_API_URL' | 'OLLAMA_MODEL_NAME' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME' | 'PERSISTENCE_PRIORITY'>): Promise<AdminApiController>;
     private constructor();
     /**
-     * Serves the API and web assets; this blocks until stop() is called.
-     * If the given port is 0, a random port is assigned.
+     * Binds the API/web-asset server to `port` and resolves once the socket is
+     * listening. If the given port is 0, a random port is assigned. Rejects on
+     * bind errors (e.g. EADDRINUSE) so callers — particularly those doing a
+     * stop/start bounce — can recover instead of crashing on an uncaught
+     * 'error' event.
      */
-    start(port: number): void;
+    start(port: number): Promise<void>;
     /**
-     * Stops the server.
+     * Stops accepting new connections and forcibly tears down any in-flight
+     * ones, then resolves. Forceful close keeps bounces predictable — a slow
+     * or stuck client request can't hold the port open. Callers that want to
+     * let in-flight work drain should do so before invoking stop().
      */
-    stop(): void;
+    stop(): Promise<void>;
     private static setupExpressFramework;
     /**
      * Sets up URL error handler middleware to catch URL parsing/decoding errors.

package/dist/managers/AdminApiController.js

@@ -87,22 +87,35 @@ class AdminApiController {
         this.app = app;
     }
     /**
-     * Serves the API and web assets; this blocks until stop() is called.
-     * If the given port is 0, a random port is assigned.
+     * Binds the API/web-asset server to `port` and resolves once the socket is
+     * listening. If the given port is 0, a random port is assigned. Rejects on
+     * bind errors (e.g. EADDRINUSE) so callers — particularly those doing a
+     * stop/start bounce — can recover instead of crashing on an uncaught
+     * 'error' event.
      */
-    start(port) {
+    async start(port) {
         Logger_1.appLogger.debug(`Starting AdminController on port ${port}`);
-        this.server = this.app.listen(port);
+        await new Promise((resolve, reject) => {
+            this.server = this.app.listen(port, () => resolve());
+            this.server.once('error', reject);
+        });
     }
     /**
-     * Stops the server.
+     * Stops accepting new connections and forcibly tears down any in-flight
+     * ones, then resolves. Forceful close keeps bounces predictable — a slow
+     * or stuck client request can't hold the port open. Callers that want to
+     * let in-flight work drain should do so before invoking stop().
      */
-    stop() {
+    async stop() {
         if (this.server) {
             const address = this.server.address();
             const port = typeof address === 'string' ? address : address?.port;
             Logger_1.appLogger.debug(`Stopping AdminController on port ${port}`);
-            this.server.close();
+            const server = this.server;
+            await new Promise((resolve, reject) => {
+                server.close((err) => (err ? reject(err) : resolve()));
+                server.closeAllConnections();
+            });
         }
     }
     static async setupExpressFramework(donobuDeploymentEnvironment, controlPanelFactory, environ) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "donobu",
-  "version": "5.38.1",
+  "version": "5.39.1",
   "description": "Create browser automations with an LLM agent and replay them as Playwright scripts.",
   "main": "dist/main.js",
   "module": "dist/esm/main.js",
@@ -79,7 +79,7 @@
     "ai": "^6.0.37",
     "better-sqlite3": "^12.6.2",
     "commander": "^13.0.0",
-    "env-struct": "^1.3.2",
+    "env-struct": "^1.5.0",
     "express": "^5.2.1",
     "fast-json-stable-stringify": "^2.1.0",
     "prettier": "^3.8.0",