@postxl/utils 1.3.2 → 1.3.3

package/dist/index.d.ts

@@ -2,14 +2,22 @@ import { CapitalizedKeys, ColorFn, CompareFn, Conjugated, Debrand, DeepPartial,
 
 //#region src/check-port.d.ts
 /**
-* Checks if a port is available.
+* Checks if a port is available by attempting to bind to it.
+*
+* This approach avoids outbound TCP connect timeouts that can occur with
+* mirrored WSL networking, where connection attempts may hang for extended
+* periods before timing out.
 *
 * The `net` module from Node.js is imported dynamically so that bundlers used in
 * browser environments (like Next.js) don't attempt to include it during
 * static analysis.
 */
 /**
- * Checks if a port is available.
+ * Checks if a port is available by attempting to bind to it.
+ *
+ * This approach avoids outbound TCP connect timeouts that can occur with
+ * mirrored WSL networking, where connection attempts may hang for extended
+ * periods before timing out.
  *
  * The `net` module from Node.js is imported dynamically so that bundlers used in
  * browser environments (like Next.js) don't attempt to include it during

package/dist/index.js

@@ -2,28 +2,37 @@ import { DefaultMap, ExhaustiveSwitchCheck, NestedMap, Result, TypedMapping, add
 
 //#region src/check-port.ts
 /**
-* Checks if a port is available.
+* Checks if a port is available by attempting to bind to it.
+*
+* This approach avoids outbound TCP connect timeouts that can occur with
+* mirrored WSL networking, where connection attempts may hang for extended
+* periods before timing out.
 *
 * The `net` module from Node.js is imported dynamically so that bundlers used in
 * browser environments (like Next.js) don't attempt to include it during
 * static analysis.
 */
-async function checkPortAvailability(port, host = "127.0.0.1") {
+async function checkPortAvailability(port, host = "0.0.0.0") {
 	try {
 		const net = await import("net");
 		return new Promise((resolve) => {
-			const tester = net.createConnection({
-				port,
-				host
-			}, () => {
-				tester.destroy();
-				resolve(false);
+			const server = net.createServer();
+			let settled = false;
+			const finish = (available) => {
+				if (settled) return;
+				settled = true;
+				resolve(available);
+			};
+			server.once("error", () => {
+				finish(false);
 			});
-			tester.on("error", () => {
-				resolve(true);
+			server.once("listening", () => {
+				server.close(() => finish(true));
 			});
-			tester.on("close", () => {
-				resolve(false);
+			server.listen({
+				port,
+				host,
+				exclusive: true
 			});
 		});
 	} catch {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["port: number"],"sources":["../src/check-port.ts"],"sourcesContent":["/**\n * Checks if a port is available.\n *\n * The `net` module from Node.js is imported dynamically so that bundlers used in\n * browser environments (like Next.js) don't attempt to include it during\n * static analysis.\n */\nexport async function checkPortAvailability(port: number, host = '127.0.0.1'): Promise<boolean> {\n  // Dynamically import `net` only when this function is executed in a Node.js\n  // environment. This prevents tools like Next.js from trying to bundle the\n  // `net` module when other utilities from this package are imported in the\n  // browser.\n  try {\n    const net = await import('net')\n\n    return new Promise((resolve) => {\n      const tester = net.createConnection({ port, host }, () => {\n        // Port can be connected to, so something is listening on it\n        tester.destroy()\n        resolve(false)\n      })\n      // Port cannot be connected to, so it is available\n      tester.on('error', () => {\n        resolve(true)\n      })\n      // Port is available\n      tester.on('close', () => {\n        resolve(false)\n      })\n    })\n  } catch {\n    throw new Error('checkPortAvailability is only available in a Node.js environment')\n  }\n}\n\n// Backwards compatibility alias\nexport const checkPort = checkPortAvailability\n"],"mappings":";;;;;;;;;;AAOA,eAAsB,sBAAsBA,MAAc,OAAO,aAA+B;AAK9F,KAAI;EACF,MAAM,MAAM,MAAM,OAAO;AAEzB,SAAO,IAAI,QAAQ,CAAC,YAAY;GAC9B,MAAM,SAAS,IAAI,iBAAiB;IAAE;IAAM;GAAM,GAAE,MAAM;AAExD,WAAO,SAAS;AAChB,YAAQ,MAAM;GACf,EAAC;AAEF,UAAO,GAAG,SAAS,MAAM;AACvB,YAAQ,KAAK;GACd,EAAC;AAEF,UAAO,GAAG,SAAS,MAAM;AACvB,YAAQ,MAAM;GACf,EAAC;EACH;CACF,QAAO;AACN,QAAM,IAAI,MAAM;CACjB;AACF;AAGD,MAAa,YAAY"}
+{"version":3,"file":"index.js","names":["port: number","available: boolean"],"sources":["../src/check-port.ts"],"sourcesContent":["/**\n * Checks if a port is available by attempting to bind to it.\n *\n * This approach avoids outbound TCP connect timeouts that can occur with\n * mirrored WSL networking, where connection attempts may hang for extended\n * periods before timing out.\n *\n * The `net` module from Node.js is imported dynamically so that bundlers used in\n * browser environments (like Next.js) don't attempt to include it during\n * static analysis.\n */\nexport async function checkPortAvailability(port: number, host = '0.0.0.0'): Promise<boolean> {\n  // Dynamically import `net` only when this function is executed in a Node.js\n  // environment. This prevents tools like Next.js from trying to bundle the\n  // `net` module when other utilities from this package are imported in the\n  // browser.\n  try {\n    const net = await import('net')\n\n    return new Promise((resolve) => {\n      const server = net.createServer()\n      let settled = false\n\n      const finish = (available: boolean) => {\n        if (settled) {\n          return\n        }\n        settled = true\n        resolve(available)\n      }\n\n      server.once('error', () => {\n        // Port is already in use or cannot be bound\n        finish(false)\n      })\n\n      server.once('listening', () => {\n        // Port is available, close the server and resolve\n        server.close(() => finish(true))\n      })\n\n      server.listen({ port, host, exclusive: true })\n    })\n  } catch {\n    throw new Error('checkPortAvailability is only available in a Node.js environment')\n  }\n}\n\n// Backwards compatibility alias\nexport const checkPort = checkPortAvailability\n"],"mappings":";;;;;;;;;;;;;;AAWA,eAAsB,sBAAsBA,MAAc,OAAO,WAA6B;AAK5F,KAAI;EACF,MAAM,MAAM,MAAM,OAAO;AAEzB,SAAO,IAAI,QAAQ,CAAC,YAAY;GAC9B,MAAM,SAAS,IAAI,cAAc;GACjC,IAAI,UAAU;GAEd,MAAM,SAAS,CAACC,cAAuB;AACrC,QAAI,QACF;AAEF,cAAU;AACV,YAAQ,UAAU;GACnB;AAED,UAAO,KAAK,SAAS,MAAM;AAEzB,WAAO,MAAM;GACd,EAAC;AAEF,UAAO,KAAK,aAAa,MAAM;AAE7B,WAAO,MAAM,MAAM,OAAO,KAAK,CAAC;GACjC,EAAC;AAEF,UAAO,OAAO;IAAE;IAAM;IAAM,WAAW;GAAM,EAAC;EAC/C;CACF,QAAO;AACN,QAAM,IAAI,MAAM;CACjB;AACF;AAGD,MAAa,YAAY"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postxl/utils",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "Shared utility functions for PostXL code generation framework",
   "type": "module",
   "main": "./dist/index.js",