@amodalai/amodal 0.2.9 → 0.3.0

package/dist/src/shared/find-free-port.js

@@ -0,0 +1,62 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { createServer } from 'node:net';
+/**
+ * Find a free TCP port, starting from `preferred`. If `preferred` is taken,
+ * tries incrementally higher ports up to `preferred + maxAttempts`.
+ *
+ * Uses the "bind then close" technique: creates a TCP server on the candidate
+ * port, reads the actual assigned port, then closes the server. This avoids
+ * TOCTOU races better than simply checking if a port is open — the OS reserves
+ * the port for the brief lifetime of the server.
+ */
+export async function findFreePort(preferred, maxAttempts = 10) {
+    for (let offset = 0; offset < maxAttempts; offset++) {
+        const candidate = preferred + offset;
+        const port = await tryPort(candidate);
+        if (port !== null)
+            return port;
+    }
+    // Fallback: let the OS pick any available port
+    const port = await tryPort(0);
+    if (port !== null)
+        return port;
+    throw new PortAllocationError(preferred, maxAttempts);
+}
+/**
+ * Attempt to bind a TCP server to the given port. Returns the port number on
+ * success, or null if the port is in use.
+ */
+function tryPort(port) {
+    return new Promise((resolve) => {
+        const server = createServer();
+        server.once('error', () => {
+            resolve(null);
+        });
+        server.listen(port, '127.0.0.1', () => {
+            const addr = server.address();
+            const assignedPort = typeof addr === 'object' && addr !== null ? addr.port : null;
+            server.close(() => {
+                resolve(assignedPort);
+            });
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Error
+// ---------------------------------------------------------------------------
+export class PortAllocationError extends Error {
+    preferred;
+    maxAttempts;
+    constructor(preferred, maxAttempts) {
+        super(`Failed to find a free port starting from ${String(preferred)} ` +
+            `after ${String(maxAttempts)} attempts`);
+        this.name = 'PortAllocationError';
+        this.preferred = preferred;
+        this.maxAttempts = maxAttempts;
+    }
+}
+//# sourceMappingURL=find-free-port.js.map

package/dist/src/shared/find-free-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-free-port.js","sourceRoot":"","sources":["../../../src/shared/find-free-port.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB,EAAE,WAAW,GAAG,EAAE;IACpE,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;IACjC,CAAC;IACD,+CAA+C;IAC/C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,IAAI,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACxB,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;YACpC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,YAAY,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YAClF,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;gBAChB,OAAO,CAAC,YAAY,CAAC,CAAC;YACxB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,SAAS,CAAS;IAClB,WAAW,CAAS;IAE7B,YAAY,SAAiB,EAAE,WAAmB;QAChD,KAAK,CACH,4CAA4C,MAAM,CAAC,SAAS,CAAC,GAAG;YAChE,SAAS,MAAM,CAAC,WAAW,CAAC,WAAW,CACxC,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF"}