@gachlab/devup 0.8.0 → 0.9.0

package/dist/process/health.d.ts

@@ -1,6 +1,23 @@
 import type { HealthStatus } from './types.js';
 import type { HealthCheckConfig } from '../config/types.js';
+/** "Is something accepting connections at port?" — connect-based test.
+ *  Use this for health checks and waitForPort, where "occupied" means
+ *  "the service is up". Do NOT use this to decide whether to spawn — use
+ *  `isPortBindable` instead (a bound but pre-accept server would slip
+ *  through this check). */
 export declare function checkPort(port: number, host?: string, timeoutMs?: number): Promise<boolean>;
+/** "Can I bind to this port right now?" — bind-based test. Returns true
+ *  if a server could listen on the port on every wildcard address. Used as
+ *  the pre-flight before spawning a service: catches every case that would
+ *  cause the spawned process to die with EADDRINUSE, including bound-but-
+ *  not-yet-accepting states that `checkPort` misses.
+ *
+ *  Implementation detail: tests both IPv4 (`0.0.0.0`) and IPv6 (`::`)
+ *  wildcards. On Linux these usually share an address space (IPV6_V6ONLY=0),
+ *  so a single test suffices; on Windows the defaults isolate the stacks,
+ *  so a one-stack test can miss a conflicting bind on the other. We require
+ *  both stacks to be free to call the port bindable. */
+export declare function isPortBindable(port: number): Promise<boolean>;
 export declare function checkHttp(port: number, opts?: {
     path?: string;
     expect?: number | number[];

package/dist/process/health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/process/health.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAc,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAS9F;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1F,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAOlF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAa9G;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY,CAI/E"}
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/process/health.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;2BAI2B;AAC3B,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAc,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAS9F;AAED;;;;;;;;;;wDAUwD;AACxD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQnE;AAgBD,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1F,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAOlF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAa9G;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY,CAI/E"}

package/dist/process/port-conflicts.d.ts

@@ -0,0 +1,33 @@
+import type { ServiceConfig } from '../config/types.js';
+export interface PortHolder {
+    pid: number;
+    command: string;
+}
+export interface PortConflict {
+    service: string;
+    port: number;
+    holder: PortHolder | null;
+}
+/** Run `lsof` to find what's listening on a port. Returns the first matching
+ *  PID + command, or null if nothing's there (or lsof isn't available). */
+export declare function findPortHolder(port: number): Promise<PortHolder | null>;
+/** Scan every API-typed service for port conflicts. (Webs are usually managed
+ *  by their own dev server which sometimes handles port collisions itself, so
+ *  we leave them alone — matching the spawner's pre-flight scope.) */
+export declare function scanPortConflicts(services: ServiceConfig[]): Promise<PortConflict[]>;
+/** SIGTERM with grace, falling back to SIGKILL after `graceMs`. */
+export declare function killHolder(pid: number, graceMs?: number): Promise<boolean>;
+export interface ResolveOpts {
+    autoKill: boolean;
+    out: (line: string) => void;
+    /** Returns true if user confirms, false otherwise. Skipped when autoKill or
+     *  when stdin is not a TTY. */
+    prompt?: () => Promise<boolean>;
+    /** If stdin is not a TTY and autoKill is false, resolution fails by default.
+     *  Tests pass `isInteractive: true` with a mocked prompt to bypass. */
+    isInteractive?: boolean;
+}
+/** Returns true if all conflicts were resolved (no holders left), false if the
+ *  user declined or some kills failed. */
+export declare function resolvePortConflicts(conflicts: PortConflict[], opts: ResolveOpts): Promise<boolean>;
+//# sourceMappingURL=port-conflicts.d.ts.map

package/dist/process/port-conflicts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-conflicts.d.ts","sourceRoot":"","sources":["../../src/process/port-conflicts.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CAC3B;AAID;2EAC2E;AAC3E,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAa7E;AAuBD;;sEAEsE;AACtE,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAU1F;AAED,mEAAmE;AACnE,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAW9E;AAMD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B;mCAC+B;IAC/B,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC;2EACuE;IACvE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;0CAC0C;AAC1C,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,YAAY,EAAE,EACzB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,OAAO,CAAC,CAgClB"}

package/dist/process/spawner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawner.d.ts","sourceRoot":"","sources":["../../src/process/spawner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjC,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IACzB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,wFAAwF;IACxF,OAAO,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9E;AAED;;4EAE4E;AAC5E,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyB;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,IAAI,EAAE,WAAW;IAUvB,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA4DnF,OAAO,CAAC,SAAS;IA0BjB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,eAAe;IAgBvB;gEAC4D;IAC5D,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,GAAG;CAGZ"}
+{"version":3,"file":"spawner.d.ts","sourceRoot":"","sources":["../../src/process/spawner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjC,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IACzB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,wFAAwF;IACxF,OAAO,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9E;AAED;;4EAE4E;AAC5E,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyB;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,IAAI,EAAE,WAAW;IAUvB,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA+DnF,OAAO,CAAC,SAAS;IA0BjB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,eAAe;IAgBvB;gEAC4D;IAC5D,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,GAAG;CAGZ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gachlab/devup",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Dev stack runner with TUI, lazy proxy, and reverse proxy support",
   "type": "module",
   "main": "dist/index.js",