@dbx-tools/shared-core 0.1.9 → 0.1.11

package/package.json

@@ -16,7 +16,7 @@
   },
   "main": "index.ts",
   "license": "UNLICENSED",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "types": "index.ts",
   "type": "module",
   "exports": {

package/src/net.ts

@@ -178,9 +178,9 @@ export function urlBuilder(): UrlBuilder;
  * urlBuilder({ url: "http://y" });    // http://y/
  * urlBuilder();                       // http://localhost/
  */
-export function urlBuilder(input?: UrlLike): UrlBuilder | null;
+export function urlBuilder(input?: UrlLike): UrlBuilder | undefined;
 
-export function urlBuilder(input?: UrlLike): UrlBuilder | null {
+export function urlBuilder(input?: UrlLike): UrlBuilder | undefined {
   if (input instanceof URL) {
     return new UrlBuilderImpl(input);
   }
@@ -210,7 +210,7 @@ export function urlBuilder(input?: UrlLike): UrlBuilder | null {
     return urlBuilder(defaultUrl());
   }
   const url = parseUrl(input);
-  return url ? urlBuilder(url) : null;
+  return url ? urlBuilder(url) : undefined;
 }
 
 /**
@@ -255,7 +255,7 @@ function parseUrl(input: string): URL | null {
   if (input && input.includes(URL_SCHEME_SEPARATOR)) {
     try {
       return new URL(input);
-    } catch {}
+    } catch { }
   }
   return null;
 }
@@ -449,6 +449,27 @@ export function findContainingCidr<T extends Cidr>(
   return null;
 }
 
+/**
+ * Whether `input`'s host is a loopback address - `localhost`, an IPv4
+ * `127.0.0.0/8` address, or IPv6 `::1` - i.e. a service running on this
+ * machine (e.g. a local registry). Accepts anything {@link urlBuilder}
+ * coerces (a URL string, `URL`, or `{ url }`); returns `false` when the
+ * input has no resolvable host.
+ *
+ * @example
+ * isLoopbackHost("http://localhost:4873"); // true
+ * isLoopbackHost("http://127.0.0.1");       // true
+ * isLoopbackHost("https://registry.npmjs.org"); // false
+ */
+export function isLoopbackHost(input: UrlLike): boolean {
+  const host = urlBuilder(input)?.hostname;
+  if (!host) return false;
+  if (host === "localhost") return true;
+  // `URL` brackets an IPv6 host (`[::1]`); strip them before parsing.
+  const ip = host.replace(/^\[|\]$/g, "");
+  return ipInCidr(ip, "127.0.0.0/8") || ipInCidr(ip, "::1/128");
+}
+
 /**
  * Network mask for `prefix` leading bits of a `bits`-wide address as a
  * `bigint`: the top `prefix` bits set, the low host bits cleared.