@prosopo/ipinfo 0.2.40 → 0.3.0

package/dist/tests/ipinfo.test-d.js

@@ -0,0 +1,97 @@
+import { assertType, describe, expectTypeOf, it } from "vitest";
+import { parseAbuserScore } from "../backends/ipapi.js";
+import { IpInfoService, IpapiBackend, MaxMindBackend, isNonRoutable, } from "../index.js";
+describe("IpInfoService", () => {
+    it("satisfies the interface it claims to implement", () => {
+        expectTypeOf().toMatchTypeOf();
+    });
+    it("takes a config and optional injected backends", () => {
+        expectTypeOf(IpInfoService).toBeConstructibleWith({});
+        expectTypeOf(IpInfoService).toBeConstructibleWith({}, {});
+        expectTypeOf(IpInfoService).toBeConstructibleWith({ ipapiUrl: "https://api.ipapi.is" }, { maxmind: null, ipapi: null });
+    });
+    it("resolves lookup to the shared response union, never a bare result", () => {
+        expectTypeOf().returns.toEqualTypeOf();
+    });
+    it("exposes initialize and isAvailable with no arguments", () => {
+        expectTypeOf().parameters.toEqualTypeOf();
+        expectTypeOf().returns.toEqualTypeOf();
+        expectTypeOf().returns.toEqualTypeOf();
+    });
+    it("keeps every config field optional", () => {
+        assertType({});
+    });
+    it("rejects an unknown config key", () => {
+        assertType({ maxmindDbPath: "/city.mmdb" });
+    });
+    it("rejects a config value of the wrong type", () => {
+        assertType({ ipapiUrl: new URL("https://x.test") });
+    });
+});
+describe("IpInfoBackends", () => {
+    it("accepts null for a backend that is deliberately absent", () => {
+        assertType({ maxmind: null, ipapi: null });
+        assertType({});
+    });
+    it("does not accept an arbitrary object as a backend", () => {
+        assertType({ maxmind: { lookup: () => undefined } });
+    });
+});
+describe("isNonRoutable", () => {
+    it("takes exactly one string and returns a boolean", () => {
+        expectTypeOf(isNonRoutable).parameters.toEqualTypeOf();
+        expectTypeOf(isNonRoutable).returns.toEqualTypeOf();
+    });
+});
+describe("parseAbuserScore", () => {
+    it("accepts the optional upstream field", () => {
+        expectTypeOf(parseAbuserScore).parameters.toEqualTypeOf();
+    });
+    it("returns an optional number, so callers must handle 'unknown'", () => {
+        expectTypeOf(parseAbuserScore).returns.toEqualTypeOf();
+        expectTypeOf(parseAbuserScore(undefined)).toEqualTypeOf();
+    });
+});
+describe("FetchFn", () => {
+    it("matches the global fetch closely enough to be its default", () => {
+        expectTypeOf().toMatchTypeOf();
+    });
+    it("returns the global Response, not a hand-rolled shape", () => {
+        expectTypeOf().returns.toEqualTypeOf();
+    });
+    it("takes a url and an init", () => {
+        expectTypeOf().parameters.toEqualTypeOf();
+    });
+});
+describe("OpenReader", () => {
+    it("takes a path and resolves to a reader", () => {
+        expectTypeOf().parameters.toEqualTypeOf();
+        expectTypeOf().returns.toMatchTypeOf();
+    });
+});
+describe("backend constructors", () => {
+    it("require a base url for ipapi and accept the injection seams", () => {
+        expectTypeOf(IpapiBackend).toBeConstructibleWith({
+            baseUrl: "https://x.test",
+        });
+        expectTypeOf(IpapiBackend).toBeConstructibleWith({
+            baseUrl: "https://x.test",
+            apiKey: "k",
+            timeoutMs: 100,
+            fetch: async () => new Response(),
+        });
+    });
+    it("leave every MaxMind option optional", () => {
+        expectTypeOf(MaxMindBackend).toBeConstructibleWith({});
+        expectTypeOf(MaxMindBackend).toBeConstructibleWith({
+            cityDbPath: "/city.mmdb",
+            asnDbPath: "/asn.mmdb",
+        });
+    });
+    it("give both backends the same lookup signature as the service", () => {
+        expectTypeOf().parameters.toEqualTypeOf();
+        expectTypeOf().parameters.toEqualTypeOf();
+        expectTypeOf().returns.toEqualTypeOf();
+    });
+});
+//# sourceMappingURL=ipinfo.test-d.js.map

package/dist/tests/ipinfo.test-d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipinfo.test-d.js","sourceRoot":"","sources":["../../src/tests/ipinfo.test-d.ts"],"names":[],"mappings":"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"}

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

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

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

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

package/dist/tests/maxmind.unit.test.js

@@ -0,0 +1,391 @@
+import { describe, expect, it, vi } from "vitest";
+import { MaxMindBackend, } from "../backends/maxmind.js";
+const IP = "8.8.8.8";
+const CITY_DB = "/dbs/GeoLite2-City.mmdb";
+const ASN_DB = "/dbs/GeoLite2-ASN.mmdb";
+const reader = (behaviour) => {
+    const notSupported = () => {
+        throw new Error("database does not support this lookup");
+    };
+    return {
+        city: behaviour.city ?? notSupported,
+        asn: behaviour.asn ?? notSupported,
+    };
+};
+const cityData = (overrides = {}) => ({
+    country: { isoCode: "US", names: { en: "United States" } },
+    city: { names: { en: "Mountain View" } },
+    subdivisions: [{ names: { en: "California" } }],
+    location: {
+        latitude: 37.4,
+        longitude: -122.1,
+        timeZone: "America/Los_Angeles",
+    },
+    traits: {},
+    ...overrides,
+});
+const asnData = (overrides = {}) => ({
+    autonomousSystemNumber: 15169,
+    autonomousSystemOrganization: "Google LLC",
+    ...overrides,
+});
+const opens = (readers) => {
+    return async (dbPath) => {
+        const model = dbPath === CITY_DB ? readers.city : readers.asn;
+        if (undefined === model) {
+            throw new Error(`no database at ${dbPath}`);
+        }
+        return model;
+    };
+};
+const expectValid = (response) => {
+    if (!response.isValid) {
+        throw new Error(`expected a valid result, got: ${response.error}`);
+    }
+    return response;
+};
+describe("MaxMindBackend.initialize", () => {
+    it("opens only the databases that are configured", async () => {
+        const openReader = vi.fn(opens({ city: reader({ city: () => cityData() }) }));
+        const backend = new MaxMindBackend({ cityDbPath: CITY_DB, openReader });
+        await backend.initialize();
+        expect(openReader).toHaveBeenCalledTimes(1);
+        expect(openReader).toHaveBeenCalledWith(CITY_DB);
+    });
+    it("opens neither database when no paths are configured", async () => {
+        const openReader = vi.fn(opens({}));
+        await new MaxMindBackend({ openReader }).initialize();
+        expect(openReader).not.toHaveBeenCalled();
+    });
+    it("logs the readers it did open", async () => {
+        const info = vi.fn();
+        await new MaxMindBackend({
+            cityDbPath: CITY_DB,
+            asnDbPath: ASN_DB,
+            openReader: opens({
+                city: reader({ city: () => cityData() }),
+                asn: reader({ asn: () => asnData() }),
+            }),
+            logger: { info, warn: vi.fn(), debug: vi.fn() },
+        }).initialize();
+        const messages = info.mock.calls.map((call) => call[0]().msg);
+        expect(messages).toEqual([
+            "MaxMind City reader initialized",
+            "MaxMind ASN reader initialized",
+        ]);
+    });
+    it("keeps the ASN database when the City database fails to open", async () => {
+        const backend = new MaxMindBackend({
+            cityDbPath: CITY_DB,
+            asnDbPath: ASN_DB,
+            openReader: opens({ asn: reader({ asn: () => asnData() }) }),
+        });
+        await backend.initialize();
+        expect(backend.isAvailable()).toBe(true);
+    });
+    it("does not throw when every database fails to open", async () => {
+        const backend = new MaxMindBackend({
+            cityDbPath: CITY_DB,
+            asnDbPath: ASN_DB,
+            openReader: opens({}),
+        });
+        await expect(backend.initialize()).resolves.toBeUndefined();
+        expect(backend.isAvailable()).toBe(false);
+    });
+    it("logs a warning for each database it could not open", async () => {
+        const warn = vi.fn();
+        const backend = new MaxMindBackend({
+            cityDbPath: CITY_DB,
+            asnDbPath: ASN_DB,
+            openReader: opens({}),
+            logger: { warn, info: vi.fn(), debug: vi.fn() },
+        });
+        await backend.initialize();
+        expect(warn).toHaveBeenCalledTimes(2);
+        const messages = warn.mock.calls.map((call) => call[0]().msg);
+        expect(messages).toEqual([
+            "Failed to initialize MaxMind City reader",
+            "Failed to initialize MaxMind ASN reader",
+        ]);
+    });
+    it("is safe to call twice", async () => {
+        const backend = new MaxMindBackend({
+            cityDbPath: CITY_DB,
+            openReader: opens({ city: reader({ city: () => cityData() }) }),
+        });
+        await backend.initialize();
+        await backend.initialize();
+        expect(backend.isAvailable()).toBe(true);
+    });
+});
+describe("MaxMindBackend.isAvailable", () => {
+    it("is unavailable before initialize, even when paths are configured", async () => {
+        const backend = new MaxMindBackend({
+            cityDbPath: CITY_DB,
+            openReader: opens({ city: reader({ city: () => cityData() }) }),
+        });
+        expect(backend.isAvailable()).toBe(false);
+        await backend.initialize();
+        expect(backend.isAvailable()).toBe(true);
+    });
+});
+describe("MaxMindBackend.lookup", () => {
+    const initialised = async (readers) => {
+        const backend = new MaxMindBackend({
+            cityDbPath: readers.city ? CITY_DB : undefined,
+            asnDbPath: readers.asn ? ASN_DB : undefined,
+            openReader: opens(readers),
+        });
+        await backend.initialize();
+        return backend;
+    };
+    it("refuses to look up before the databases are open", async () => {
+        const backend = new MaxMindBackend({ cityDbPath: CITY_DB });
+        await expect(backend.lookup(IP)).resolves.toEqual({
+            isValid: false,
+            error: "MaxMind readers not initialized",
+            ip: IP,
+        });
+    });
+    it("maps city data onto the shared result shape", async () => {
+        const backend = await initialised({
+            city: reader({ city: () => cityData() }),
+        });
+        const result = expectValid(await backend.lookup(IP));
+        expect(result).toMatchObject({
+            ip: IP,
+            isValid: true,
+            country: "United States",
+            countryCode: "US",
+            region: "California",
+            city: "Mountain View",
+            latitude: 37.4,
+            longitude: -122.1,
+            timezone: "America/Los_Angeles",
+        });
+    });
+    it("reports threat indicators the free databases never populate as false", async () => {
+        const backend = await initialised({
+            city: reader({ city: () => cityData() }),
+        });
+        const result = expectValid(await backend.lookup(IP));
+        expect(result.isVPN).toBe(false);
+        expect(result.isTor).toBe(false);
+        expect(result.isProxy).toBe(false);
+        expect(result.isAbuser).toBe(false);
+        expect(result.isMobile).toBe(false);
+        expect(result.isCrawler).toBe(false);
+    });
+    it("reads the anonymity traits when a paid database supplies them", async () => {
+        const backend = await initialised({
+            city: reader({
+                city: () => cityData({
+                    traits: {
+                        isAnonymousVpn: true,
+                        isTorExitNode: true,
+                        isHostingProvider: true,
+                        isSatelliteProvider: true,
+                    },
+                }),
+            }),
+        });
+        const result = expectValid(await backend.lookup(IP));
+        expect(result.isVPN).toBe(true);
+        expect(result.isTor).toBe(true);
+        expect(result.isDatacenter).toBe(true);
+        expect(result.isSatellite).toBe(true);
+    });
+    it("treats a residential proxy as a proxy", async () => {
+        const residential = await initialised({
+            city: reader({
+                city: () => cityData({ traits: { isResidentialProxy: true } }),
+            }),
+        });
+        const publicProxy = await initialised({
+            city: reader({
+                city: () => cityData({ traits: { isPublicProxy: true } }),
+            }),
+        });
+        expect(expectValid(await residential.lookup(IP)).isProxy).toBe(true);
+        expect(expectValid(await publicProxy.lookup(IP)).isProxy).toBe(true);
+    });
+    it("falls back to the ASN database for the AS number", async () => {
+        const backend = await initialised({
+            city: reader({ city: () => cityData() }),
+            asn: reader({ asn: () => asnData() }),
+        });
+        const result = expectValid(await backend.lookup(IP));
+        expect(result.asnNumber).toBe(15169);
+        expect(result.asnOrganization).toBe("Google LLC");
+    });
+    it("prefers the City database's ASN traits over the ASN database", async () => {
+        const backend = await initialised({
+            city: reader({
+                city: () => cityData({
+                    traits: {
+                        autonomousSystemNumber: 111,
+                        autonomousSystemOrganization: "From City",
+                    },
+                }),
+            }),
+            asn: reader({ asn: () => asnData({ autonomousSystemNumber: 222 }) }),
+        });
+        const result = expectValid(await backend.lookup(IP));
+        expect(result.asnNumber).toBe(111);
+        expect(result.asnOrganization).toBe("From City");
+    });
+    it("returns ASN-only data when no City database is configured", async () => {
+        const backend = await initialised({
+            asn: reader({ asn: () => asnData() }),
+        });
+        const result = expectValid(await backend.lookup(IP));
+        expect(result.asnNumber).toBe(15169);
+        expect(result.country).toBeUndefined();
+    });
+    it("reports no data when the IP is in neither database", async () => {
+        const missing = () => {
+            throw new Error("address not found");
+        };
+        const backend = await initialised({
+            city: reader({ city: missing }),
+            asn: reader({ asn: missing }),
+        });
+        await expect(backend.lookup(IP)).resolves.toEqual({
+            isValid: false,
+            error: "No MaxMind data available for IP",
+            ip: IP,
+        });
+    });
+    it("still answers from the ASN database when the City lookup throws", async () => {
+        const backend = await initialised({
+            city: reader({
+                city: () => {
+                    throw new Error("address not found");
+                },
+            }),
+            asn: reader({ asn: () => asnData() }),
+        });
+        const result = expectValid(await backend.lookup(IP));
+        expect(result.asnNumber).toBe(15169);
+        expect(result.country).toBeUndefined();
+    });
+    it("maps a hosting user type onto the provider type", async () => {
+        const backend = await initialised({
+            city: reader({
+                city: () => cityData({ traits: { userType: "hosting" } }),
+            }),
+        });
+        expect(expectValid(await backend.lookup(IP)).providerType).toBe("hosting");
+    });
+    it("maps every user type MaxMind can emit", async () => {
+        const forUserType = async (userType) => {
+            const backend = await initialised({
+                city: reader({
+                    city: () => cityData({ traits: { userType } }),
+                }),
+            });
+            return expectValid(await backend.lookup(IP)).providerType;
+        };
+        const expected = {
+            hosting: "hosting",
+            content_delivery_network: "hosting",
+            college: "education",
+            school: "education",
+            library: "education",
+            government: "government",
+            military: "government",
+            business: "business",
+            residential: "isp",
+            cellular: "isp",
+            dialup: "isp",
+            cafe: "isp",
+            traveler: "isp",
+            router: "isp",
+            consumer_privacy_network: undefined,
+            search_engine_spider: undefined,
+        };
+        for (const [userType, providerType] of Object.entries(expected)) {
+            expect(await forUserType(userType), userType).toBe(providerType);
+        }
+    });
+    it("logs each failed database lookup with the IP and the cause", async () => {
+        const debug = vi.fn();
+        const missing = () => {
+            throw new Error("address not found");
+        };
+        const backend = new MaxMindBackend({
+            cityDbPath: CITY_DB,
+            asnDbPath: ASN_DB,
+            openReader: opens({
+                city: reader({ city: missing }),
+                asn: reader({ asn: missing }),
+            }),
+            logger: { debug, warn: vi.fn(), info: vi.fn() },
+        });
+        await backend.initialize();
+        await backend.lookup(IP);
+        expect(debug).toHaveBeenCalledTimes(2);
+        const payloads = debug.mock.calls.map((call) => call[0]());
+        expect(payloads.map((p) => p.msg)).toEqual([
+            "MaxMind City lookup failed",
+            "MaxMind ASN lookup failed",
+        ]);
+        expect(payloads.every((p) => p.data.ip === IP)).toBe(true);
+    });
+    it("leaves the provider type unset for a user type it does not map", async () => {
+        const backend = await initialised({
+            city: reader({
+                city: () => cityData({
+                    traits: { userType: "search_engine_spider" },
+                }),
+            }),
+        });
+        expect(expectValid(await backend.lookup(IP)).providerType).toBeUndefined();
+    });
+    it("leaves the provider type unset when there is no user type at all", async () => {
+        const backend = await initialised({
+            city: reader({ city: () => cityData() }),
+        });
+        expect(expectValid(await backend.lookup(IP)).providerType).toBeUndefined();
+    });
+    it("turns a failure during mapping into an error response", async () => {
+        const hostile = {
+            get traits() {
+                throw new Error("corrupt record");
+            },
+        };
+        const backend = await initialised({
+            city: reader({ city: () => hostile }),
+        });
+        await expect(backend.lookup(IP)).resolves.toEqual({
+            isValid: false,
+            error: "MaxMind lookup error: corrupt record",
+            ip: IP,
+        });
+    });
+    it("describes a non-Error failure without printing [object Object]", async () => {
+        const hostile = {
+            get traits() {
+                throw "just a string";
+            },
+        };
+        const backend = await initialised({
+            city: reader({ city: () => hostile }),
+        });
+        const response = await backend.lookup(IP);
+        expect(response).toMatchObject({
+            isValid: false,
+            error: "MaxMind lookup error: just a string",
+        });
+    });
+});
+describe("MaxMindBackend default reader", () => {
+    it("does not throw when the real database file is missing", async () => {
+        const backend = new MaxMindBackend({
+            cityDbPath: "/nonexistent/prosopo-test/GeoLite2-City.mmdb",
+        });
+        await expect(backend.initialize()).resolves.toBeUndefined();
+        expect(backend.isAvailable()).toBe(false);
+    });
+});
+//# sourceMappingURL=maxmind.unit.test.js.map

package/dist/tests/maxmind.unit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maxmind.unit.test.js","sourceRoot":"","sources":["../../src/tests/maxmind.unit.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@prosopo/ipinfo",
-	"version": "0.2.40",
+	"version": "0.3.0",
 	"description": "IP information service with MaxMind and ipapi.is backends",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -22,22 +22,24 @@
 		"build:cross-env": "vite build --config vite.esm.config.ts",
 		"build:tsc": "tsc --build --verbose",
 		"build:cjs": "NODE_ENV=${NODE_ENV:-development}; vite build --config vite.cjs.config.ts --mode $NODE_ENV",
-		"typecheck": "tsc --project tsconfig.types.json"
+		"typecheck": "tsc --project tsconfig.types.json",
+		"test": "NODE_ENV=${NODE_ENV:-test}; npx vitest run --config ./vite.test.config.ts",
+		"test:watch": "NODE_ENV=${NODE_ENV:-test}; npx vitest watch --config ./vite.test.config.ts"
 	},
 	"dependencies": {
 		"@maxmind/geoip2-node": "5.0.0",
-		"@prosopo/logger": "2.0.3",
-		"@prosopo/types": "4.9.12"
+		"@prosopo/logger": "2.0.4",
+		"@prosopo/types": "4.10.0"
 	},
 	"devDependencies": {
-		"@prosopo/config": "3.3.4",
+		"@prosopo/config": "3.3.5",
 		"@types/node": "22.10.2",
-		"@vitest/coverage-v8": "3.2.4",
+		"@vitest/coverage-v8": "4.1.10",
 		"del-cli": "6.0.0",
 		"tslib": "2.7.0",
 		"typescript": "5.6.2",
-		"vite": "6.4.1",
-		"vitest": "3.2.4"
+		"vite": "8.1.5",
+		"vitest": "4.1.10"
 	},
 	"license": "Apache-2.0",
 	"repository": {

package/src/IpInfoService.ts

@@ -21,7 +21,7 @@ import type { IIpInfoService, IpInfoServiceConfig } from "./types.js";
  * Returns true for loopback, link-local, and private-range IPs that will
  * never yield useful geolocation or threat data from any backend.
  */
-function isNonRoutable(ip: string): boolean {
+export function isNonRoutable(ip: string): boolean {
 	// Strip IPv4-mapped IPv6 prefix (::ffff:127.0.0.1 -> 127.0.0.1)
 	const normalized = ip.replace(/^::ffff:/i, "");
 
@@ -54,14 +54,31 @@ function isNonRoutable(ip: string): boolean {
 	return false;
 }
 
+/**
+ * The two backends, injected so the routing and fallback logic above can be
+ * tested without a MaxMind database on disk or a network call. Both are
+ * optional: absent means "not configured", which is distinct from "configured
+ * but unavailable".
+ */
+export interface IpInfoBackends {
+	maxmind?: MaxMindBackend | null;
+	ipapi?: IpapiBackend | null;
+}
+
 export class IpInfoService implements IIpInfoService {
 	private maxmindBackend: MaxMindBackend | null = null;
 	private ipapiBackend: IpapiBackend | null = null;
 	private config: IpInfoServiceConfig;
 
-	constructor(config: IpInfoServiceConfig) {
+	constructor(config: IpInfoServiceConfig, backends?: IpInfoBackends) {
 		this.config = config;
 
+		if (backends) {
+			this.maxmindBackend = backends.maxmind ?? null;
+			this.ipapiBackend = backends.ipapi ?? null;
+			return;
+		}
+
 		if (config.maxmindCityDbPath || config.maxmindAsnDbPath) {
 			this.maxmindBackend = new MaxMindBackend({
 				cityDbPath: config.maxmindCityDbPath,