eve/dist/src/cli/dev/local-server-process.js

Filesystem-first framework for durable backend AI agents that run anywhere.

import{loadDevelopmentEnvironmentFiles}from"#cli/dev/environment.js";import{fork}from"node:child_process";import{fileURLToPath}from"node:url";import{EVE_DEV_ENV_FLAG}from"#internal/application/optional-package-install.js";const childPath=fileURLToPath(new URL(`./local-server-child.js`,import.meta.url)),DEV_SERVER_CLOSE_BUDGET_MS=800;function createDevelopmentServer(e,t={}){let n,r,i=!1,a=!1,o=Promise.withResolvers(),s=Promise.withResolvers();o.promise.catch(()=>void 0);let release=()=>{let e=n;e!==void 0&&(n=void 0,e.stdout?.destroy(),e.stderr?.destroy(),e.connected&&e.disconnect(),e.unref())};return{start:async()=>{if(n!==void 0)throw Error(`DevelopmentServer.start() was already called.`);let r={...process.env};await loadDevelopmentEnvironmentFiles(e),process.env[EVE_DEV_ENV_FLAG]??=`1`;let c=fork(childPath,[JSON.stringify({existing:t.existing,host:t.host,port:t.port})],{cwd:e,detached:!0,env:{...r,[EVE_DEV_ENV_FLAG]:`1`},stdio:[`ignore`,`pipe`,`pipe`,`ipc`]});return n=c,c.stdout?.on(`data`,e=>(t.output===`stderr`?process.stderr:process.stdout).write(e)),c.stderr?.on(`data`,e=>process.stderr.write(e)),new Promise((e,n)=>{let r=!1;c.once(`error`,n),c.once(`exit`,(e,t)=>{a=!0,s.resolve(),release(),r?i?o.resolve():o.reject(Error(`Development server exited unexpectedly (${String(e)}, ${String(t)}).`)):n(Error(`Development server exited during startup (${String(e)}, ${String(t)}).`))}),c.on(`message`,a=>{if(a.type===`progress`&&t.onBootProgress?.(a.event),a.type===`started`&&!r&&(r=!0,e(a.handle),a.handle.kind===`existing`&&(i=!0,release())),a.type===`failed`&&!r){r=!0;let e=Error(a.message);a.stack!==void 0&&(e.stack=a.stack),n(e)}})})},close(){if(r!==void 0)return r;let e=n;return e===void 0?Promise.resolve():(i=!0,r=(async()=>{e.connected&&e.send({type:`shutdown`}),!await terminatesWithin(e,s.promise,()=>a,550)&&(signalProcessGroup(e,`SIGTERM`),!await terminatesWithin(e,s.promise,()=>a,150)&&(signalProcessGroup(e,`SIGKILL`),await terminatesWithin(e,s.promise,()=>a,100),release()))})(),r)},wait:()=>o.promise}}async function terminatesWithin(e,t,n,r){let i=Date.now()+r;for(await settlesOrTimesOut(t,r);!hasTerminated(e,n())&&Date.now()<i;)await sleep(Math.min(25,i-Date.now()));return hasTerminated(e,n())}async function settlesOrTimesOut(e,t){let n;try{await Promise.race([e,new Promise(e=>{n=setTimeout(e,t)})])}finally{n!==void 0&&clearTimeout(n)}}function sleep(e){return new Promise(t=>setTimeout(t,e))}function hasTerminated(e,t){return t&&!isProcessGroupAlive(e)}function isProcessGroupAlive(e){if(process.platform===`win32`||e.pid===void 0)return!1;try{return process.kill(-e.pid,0),!0}catch{return!1}}function signalProcessGroup(e,t){if(process.platform!==`win32`&&e.pid!==void 0)try{process.kill(-e.pid,t);return}catch{}e.kill(t)}export{DEV_SERVER_CLOSE_BUDGET_MS,createDevelopmentServer};