@prosopo/ipinfo 0.2.40 → 0.3.1

package/dist/cjs/backends/ipapi.cjs

@@ -1,105 +1,119 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const TIMEOUT_MS = 700;
-class IpapiBackend {
-  constructor(config) {
-    this.config = config;
-  }
-  isAvailable() {
-    return Boolean(this.config.baseUrl);
-  }
-  async lookup(ip) {
-    try {
-      if (!ip || typeof ip !== "string") {
-        return {
-          isValid: false,
-          error: "Invalid IP address provided",
-          ip: ip || "undefined"
-        };
-      }
-      const body = { q: ip };
-      if (this.config.apiKey) {
-        body.key = this.config.apiKey;
-      }
-      const controller = new AbortController();
-      const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
-      try {
-        const response = await fetch(this.config.baseUrl, {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-            Accept: "application/json"
-          },
-          body: JSON.stringify(body),
-          signal: controller.signal
-        });
-        clearTimeout(timeoutId);
-        if (!response.ok) {
-          return {
-            isValid: false,
-            error: `API request failed with status ${response.status}: ${response.statusText}`,
-            ip
-          };
-        }
-        const data = await response.json();
-        if (data.is_bogon) {
-          return {
-            isValid: false,
-            error: "IP address is bogon (non-routable)",
-            ip
-          };
-        }
-        const result = {
-          ip: data.ip,
-          isValid: true,
-          isVPN: data.is_vpn,
-          isTor: data.is_tor,
-          isProxy: data.is_proxy,
-          isDatacenter: data.is_datacenter,
-          isAbuser: data.is_abuser,
-          isMobile: data.is_mobile,
-          isSatellite: data.is_satellite,
-          isCrawler: data.is_crawler,
-          providerName: data.company?.name || data.datacenter?.datacenter,
-          providerType: data.company?.type || data.asn?.type,
-          asnNumber: data.asn?.asn,
-          asnOrganization: data.asn?.org,
-          datacenterName: data.datacenter?.datacenter,
-          country: data.location?.country,
-          countryCode: data.location?.country_code,
-          region: data.location?.state,
-          city: data.location?.city,
-          latitude: data.location?.latitude,
-          longitude: data.location?.longitude,
-          timezone: data.location?.timezone,
-          vpnService: data.vpn?.service,
-          vpnType: data.vpn?.type,
-          abuserScore: Number.parseFloat(
-            data.asn?.abuser_score.split(" ")[0] || "0"
-          ),
-          companyAbuserScore: Number.parseFloat(
-            data.company?.abuser_score.split(" ")[0] || "0"
-          )
-        };
-        return result;
-      } catch (fetchError) {
-        clearTimeout(timeoutId);
-        if (fetchError instanceof Error && fetchError.name === "AbortError") {
-          return {
-            isValid: false,
-            error: `Request timed out after ${TIMEOUT_MS}ms`,
-            ip
-          };
-        }
-        throw fetchError;
-      }
-    } catch (error) {
-      return {
-        isValid: false,
-        error: `Network or parsing error: ${error instanceof Error ? error.message : String(error)}`,
-        ip
-      };
-    }
-  }
-}
+/**
+* Parse an upstream abuser score, which arrives as a string like "0.0012 (Low)".
+*
+* The field is declared required by the response type but is not guaranteed by
+* the wire: it comes from `response.json()`, which is cast, not validated. A
+* missing value used to throw, and the throw was caught far above as a generic
+* "Network or parsing error" — discarding an otherwise complete and successful
+* lookup over one absent score.
+*
+* Returns `undefined` — not 0 — when the field is absent or unparseable. The
+* scale is 0..1 with 0 meaning "clean" (see `abuserScoreThreshold`, declared
+* `{min: 0, max: 1}`), so a literal 0 would assert cleanliness we have not
+* established. `undefined` says "unknown" instead, and the one consumer
+* (checkTrafficFilter) already resolves it with `?? 0`, so the effective
+* blocking behaviour is unchanged while the distinction stays available.
+*
+* Fail-closed alternatives were rejected: 1 turns any upstream formatting
+* change into a silent max-severity block indistinguishable from a genuine
+* 1.0, and throwing reintroduces exactly the bug above — a cosmetic sub-field
+* collapsing a good lookup into a total failure.
+*/
+var parseAbuserScore = (score) => {
+	const head = score?.split(" ")[0];
+	if (!head) return;
+	const parsed = Number.parseFloat(head);
+	return Number.isNaN(parsed) ? void 0 : parsed;
+};
+var IpapiBackend = class {
+	constructor(config) {
+		this.config = config;
+	}
+	isAvailable() {
+		return Boolean(this.config.baseUrl);
+	}
+	get timeoutMs() {
+		return this.config.timeoutMs ?? 700;
+	}
+	async lookup(ip) {
+		try {
+			if (!ip || typeof ip !== "string") return {
+				isValid: false,
+				error: "Invalid IP address provided",
+				ip: ip || "undefined"
+			};
+			const body = { q: ip };
+			if (this.config.apiKey) body.key = this.config.apiKey;
+			const controller = new AbortController();
+			const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+			try {
+				const response = await (this.config.fetch ?? globalThis.fetch)(this.config.baseUrl, {
+					method: "POST",
+					headers: {
+						"Content-Type": "application/json",
+						Accept: "application/json"
+					},
+					body: JSON.stringify(body),
+					signal: controller.signal
+				});
+				clearTimeout(timeoutId);
+				if (!response.ok) return {
+					isValid: false,
+					error: `API request failed with status ${response.status}: ${response.statusText}`,
+					ip
+				};
+				const data = await response.json();
+				if (data.is_bogon) return {
+					isValid: false,
+					error: "IP address is bogon (non-routable)",
+					ip
+				};
+				return {
+					ip: data.ip,
+					isValid: true,
+					isVPN: data.is_vpn,
+					isTor: data.is_tor,
+					isProxy: data.is_proxy,
+					isDatacenter: data.is_datacenter,
+					isAbuser: data.is_abuser,
+					isMobile: data.is_mobile,
+					isSatellite: data.is_satellite,
+					isCrawler: data.is_crawler,
+					providerName: data.company?.name || data.datacenter?.datacenter,
+					providerType: data.company?.type || data.asn?.type,
+					asnNumber: data.asn?.asn,
+					asnOrganization: data.asn?.org,
+					datacenterName: data.datacenter?.datacenter,
+					country: data.location?.country,
+					countryCode: data.location?.country_code,
+					region: data.location?.state,
+					city: data.location?.city,
+					latitude: data.location?.latitude,
+					longitude: data.location?.longitude,
+					timezone: data.location?.timezone,
+					vpnService: data.vpn?.service,
+					vpnType: data.vpn?.type,
+					abuserScore: parseAbuserScore(data.asn?.abuser_score),
+					companyAbuserScore: parseAbuserScore(data.company?.abuser_score)
+				};
+			} catch (fetchError) {
+				clearTimeout(timeoutId);
+				if (fetchError instanceof Error && fetchError.name === "AbortError") return {
+					isValid: false,
+					error: `Request timed out after ${this.timeoutMs}ms`,
+					ip
+				};
+				throw fetchError;
+			}
+		} catch (error) {
+			return {
+				isValid: false,
+				error: `Network or parsing error: ${error instanceof Error ? error.message : String(error)}`,
+				ip
+			};
+		}
+	}
+};
+//#endregion
 exports.IpapiBackend = IpapiBackend;
+exports.parseAbuserScore = parseAbuserScore;

package/dist/cjs/backends/maxmind.cjs

@@ -1,169 +1,128 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
+//#region src/backends/maxmind.ts
+var openReaderFromFile = async (dbPath) => {
+	const { Reader } = await import("@maxmind/geoip2-node");
+	return Reader.open(dbPath);
+};
+var MaxMindBackend = class {
+	constructor(config) {
+		this.cityReader = null;
+		this.asnReader = null;
+		this.config = config;
+	}
+	async initialize() {
+		const openReader = this.config.openReader ?? openReaderFromFile;
+		if (this.config.cityDbPath) try {
+			this.cityReader = await openReader(this.config.cityDbPath);
+			this.config.logger?.info(() => ({
+				msg: "MaxMind City reader initialized",
+				data: { dbPath: this.config.cityDbPath }
+			}));
+		} catch (error) {
+			this.config.logger?.warn(() => ({
+				msg: "Failed to initialize MaxMind City reader",
+				err: error,
+				data: { dbPath: this.config.cityDbPath }
+			}));
+		}
+		if (this.config.asnDbPath) try {
+			this.asnReader = await openReader(this.config.asnDbPath);
+			this.config.logger?.info(() => ({
+				msg: "MaxMind ASN reader initialized",
+				data: { dbPath: this.config.asnDbPath }
+			}));
+		} catch (error) {
+			this.config.logger?.warn(() => ({
+				msg: "Failed to initialize MaxMind ASN reader",
+				err: error,
+				data: { dbPath: this.config.asnDbPath }
+			}));
+		}
+	}
+	isAvailable() {
+		return this.cityReader !== null || this.asnReader !== null;
+	}
+	async lookup(ip) {
+		if (!this.isAvailable()) return {
+			isValid: false,
+			error: "MaxMind readers not initialized",
+			ip
+		};
+		try {
+			let cityData;
+			let asnData;
+			if (this.cityReader) try {
+				cityData = this.cityReader.city(ip);
+			} catch (error) {
+				this.config.logger?.debug(() => ({
+					msg: "MaxMind City lookup failed",
+					data: { ip },
+					err: error
+				}));
+			}
+			if (this.asnReader) try {
+				asnData = this.asnReader.asn(ip);
+			} catch (error) {
+				this.config.logger?.debug(() => ({
+					msg: "MaxMind ASN lookup failed",
+					data: { ip },
+					err: error
+				}));
+			}
+			if (!cityData && !asnData) return {
+				isValid: false,
+				error: "No MaxMind data available for IP",
+				ip
+			};
+			return {
+				ip,
+				isValid: true,
+				isVPN: cityData?.traits?.isAnonymousVpn ?? false,
+				isTor: cityData?.traits?.isTorExitNode ?? false,
+				isProxy: (cityData?.traits?.isPublicProxy ?? false) || (cityData?.traits?.isResidentialProxy ?? false),
+				isDatacenter: cityData?.traits?.isHostingProvider ?? false,
+				isAbuser: false,
+				isMobile: false,
+				isSatellite: cityData?.traits?.isSatelliteProvider ?? false,
+				isCrawler: false,
+				country: cityData?.country?.names?.en,
+				countryCode: cityData?.country?.isoCode,
+				region: cityData?.subdivisions?.[0]?.names?.en,
+				city: cityData?.city?.names?.en,
+				latitude: cityData?.location?.latitude,
+				longitude: cityData?.location?.longitude,
+				timezone: cityData?.location?.timeZone,
+				asnNumber: cityData?.traits?.autonomousSystemNumber ?? asnData?.autonomousSystemNumber,
+				asnOrganization: cityData?.traits?.autonomousSystemOrganization ?? asnData?.autonomousSystemOrganization,
+				providerName: cityData?.traits?.autonomousSystemOrganization ?? asnData?.autonomousSystemOrganization,
+				providerType: mapUserType(cityData?.traits?.userType)
+			};
+		} catch (error) {
+			return {
+				isValid: false,
+				error: `MaxMind lookup error: ${error instanceof Error ? error.message : String(error)}`,
+				ip
+			};
+		}
+	}
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-class MaxMindBackend {
-  constructor(config) {
-    this.cityReader = null;
-    this.asnReader = null;
-    this.config = config;
-  }
-  async initialize() {
-    const { Reader } = await import("@maxmind/geoip2-node");
-    if (this.config.cityDbPath) {
-      try {
-        this.cityReader = await Reader.open(this.config.cityDbPath);
-        this.config.logger?.info(() => ({
-          msg: "MaxMind City reader initialized",
-          data: { dbPath: this.config.cityDbPath }
-        }));
-      } catch (error) {
-        this.config.logger?.warn(() => ({
-          msg: "Failed to initialize MaxMind City reader",
-          err: error,
-          data: { dbPath: this.config.cityDbPath }
-        }));
-      }
-    }
-    if (this.config.asnDbPath) {
-      try {
-        this.asnReader = await Reader.open(this.config.asnDbPath);
-        this.config.logger?.info(() => ({
-          msg: "MaxMind ASN reader initialized",
-          data: { dbPath: this.config.asnDbPath }
-        }));
-      } catch (error) {
-        this.config.logger?.warn(() => ({
-          msg: "Failed to initialize MaxMind ASN reader",
-          err: error,
-          data: { dbPath: this.config.asnDbPath }
-        }));
-      }
-    }
-  }
-  isAvailable() {
-    return this.cityReader !== null || this.asnReader !== null;
-  }
-  async lookup(ip) {
-    if (!this.isAvailable()) {
-      return {
-        isValid: false,
-        error: "MaxMind readers not initialized",
-        ip
-      };
-    }
-    try {
-      let cityData;
-      let asnData;
-      if (this.cityReader) {
-        try {
-          cityData = this.cityReader.city(ip);
-        } catch (error) {
-          this.config.logger?.debug(() => ({
-            msg: "MaxMind City lookup failed",
-            data: { ip },
-            err: error
-          }));
-        }
-      }
-      if (this.asnReader) {
-        try {
-          asnData = this.asnReader.asn(ip);
-        } catch (error) {
-          this.config.logger?.debug(() => ({
-            msg: "MaxMind ASN lookup failed",
-            data: { ip },
-            err: error
-          }));
-        }
-      }
-      if (!cityData && !asnData) {
-        return {
-          isValid: false,
-          error: "No MaxMind data available for IP",
-          ip
-        };
-      }
-      const result = {
-        ip,
-        isValid: true,
-        // Threat indicators - GeoLite2 free DBs do not populate these
-        isVPN: cityData?.traits?.isAnonymousVpn ?? false,
-        isTor: cityData?.traits?.isTorExitNode ?? false,
-        isProxy: (cityData?.traits?.isPublicProxy ?? false) || (cityData?.traits?.isResidentialProxy ?? false),
-        isDatacenter: cityData?.traits?.isHostingProvider ?? false,
-        isAbuser: false,
-        isMobile: false,
-        isSatellite: cityData?.traits?.isSatelliteProvider ?? false,
-        isCrawler: false,
-        // Geolocation from City DB
-        country: cityData?.country?.names?.en,
-        countryCode: cityData?.country?.isoCode,
-        region: cityData?.subdivisions?.[0]?.names?.en,
-        city: cityData?.city?.names?.en,
-        latitude: cityData?.location?.latitude,
-        longitude: cityData?.location?.longitude,
-        timezone: cityData?.location?.timeZone,
-        // ASN info - prefer City DB traits, fall back to ASN DB
-        asnNumber: cityData?.traits?.autonomousSystemNumber ?? asnData?.autonomousSystemNumber,
-        asnOrganization: cityData?.traits?.autonomousSystemOrganization ?? asnData?.autonomousSystemOrganization,
-        // Provider info from ASN
-        providerName: cityData?.traits?.autonomousSystemOrganization ?? asnData?.autonomousSystemOrganization,
-        providerType: mapUserType(cityData?.traits?.userType)
-      };
-      return result;
-    } catch (error) {
-      return {
-        isValid: false,
-        error: `MaxMind lookup error: ${error instanceof Error ? error.message : String(error)}`,
-        ip
-      };
-    }
-  }
-}
 function mapUserType(userType) {
-  switch (userType) {
-    case "hosting":
-    case "content_delivery_network":
-      return "hosting";
-    case "college":
-    case "school":
-    case "library":
-      return "education";
-    case "government":
-    case "military":
-      return "government";
-    case "business":
-      return "business";
-    case "residential":
-    case "cellular":
-    case "dialup":
-    case "cafe":
-    case "traveler":
-    case "router":
-      return "isp";
-    default:
-      return void 0;
-  }
+	switch (userType) {
+		case "hosting":
+		case "content_delivery_network": return "hosting";
+		case "college":
+		case "school":
+		case "library": return "education";
+		case "government":
+		case "military": return "government";
+		case "business": return "business";
+		case "residential":
+		case "cellular":
+		case "dialup":
+		case "cafe":
+		case "traveler":
+		case "router": return "isp";
+		default: return;
+	}
 }
+//#endregion
 exports.MaxMindBackend = MaxMindBackend;

package/dist/cjs/index.cjs

@@ -1,4 +1,8 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const IpInfoService = require("./IpInfoService.cjs");
-exports.IpInfoService = IpInfoService.IpInfoService;
+const require_ipapi = require("./backends/ipapi.cjs");
+const require_maxmind = require("./backends/maxmind.cjs");
+const require_IpInfoService = require("./IpInfoService.cjs");
+exports.IpInfoService = require_IpInfoService.IpInfoService;
+exports.IpapiBackend = require_ipapi.IpapiBackend;
+exports.MaxMindBackend = require_maxmind.MaxMindBackend;
+exports.isNonRoutable = require_IpInfoService.isNonRoutable;

package/dist/index.d.ts

@@ -1,3 +1,8 @@
-export { IpInfoService } from "./IpInfoService.js";
+export { IpInfoService, isNonRoutable } from "./IpInfoService.js";
+export type { IpInfoBackends } from "./IpInfoService.js";
+export { IpapiBackend } from "./backends/ipapi.js";
+export type { FetchFn, IpapiBackendConfig } from "./backends/ipapi.js";
+export { MaxMindBackend } from "./backends/maxmind.js";
+export type { MaxMindBackendConfig, OpenReader } from "./backends/maxmind.js";
 export type { IIpInfoService, IpInfoServiceConfig } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
-import { IpInfoService } from "./IpInfoService.js";
-export {
-  IpInfoService
-};
+import "./_virtual/_rolldown/runtime.js";
+import { IpapiBackend } from "./backends/ipapi.js";
+import { MaxMindBackend } from "./backends/maxmind.js";
+import { IpInfoService, isNonRoutable } from "./IpInfoService.js";
+export { IpInfoService, IpapiBackend, MaxMindBackend, isNonRoutable };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKlE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/tests/ipInfoService.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ipInfoService.unit.test.d.ts.map

package/dist/tests/ipInfoService.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipInfoService.unit.test.d.ts","sourceRoot":"","sources":["../../src/tests/ipInfoService.unit.test.ts"],"names":[],"mappings":""}