@gibme/ipinfo 1.0.1 → 2.0.0

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2016-2023 Brandon Lehmann
+Copyright (c) 2016-2025 Brandon Lehmann
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/index.d.ts

@@ -1,15 +1,38 @@
-import { PrefixInfo } from './types';
-import { CheckIP } from './web';
-export { CheckIP };
+export { ipInfo } from './web';
 /**
- * Looks up information regarding the IP address supplied
+ * Looks up information on the Autonomous System Number (ASN) via DNS
+ *
+ * @param as
+ * @param max_retries
+ * @ignore
+ */
+export declare function getASN(as: string | number, max_retries?: number): Promise<getASN.Entry | undefined>;
+export declare namespace getASN {
+    type Entry = {
+        asn: number;
+        country: string;
+        registry: string;
+        allocated: Date;
+        name: string;
+    };
+}
+/**
+ * Looks up the prefix information via DNS
  *
  * @param address
  * @param max_retries
+ * @ignore
  */
-export declare const IPInfo: (address: string, max_retries?: number) => Promise<PrefixInfo | undefined>;
-declare const _default: {
-    IPInfo: (address: string, max_retries?: number) => Promise<PrefixInfo | undefined>;
-    CheckIP: (address?: string) => Promise<import("./types").CheckIPResponse | undefined>;
-};
-export default _default;
+export declare function getPrefix(address: string, max_retries?: number): Promise<getPrefix.Info | undefined>;
+export declare namespace getPrefix {
+    type Info = {
+        address: string;
+        zone: string;
+        asn: number;
+        prefix: string;
+        country: string;
+        registry: string;
+        allocated: Date;
+        as?: getASN.Entry;
+    };
+}

package/dist/index.js

@@ -1,5 +1,5 @@
 "use strict";
-// Copyright (c) 2016-2024, Brandon Lehmann <brandonlehmann@gmail.com>
+// Copyright (c) 2016-2025, Brandon Lehmann <brandonlehmann@gmail.com>
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal
@@ -27,26 +27,126 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IPInfo = exports.CheckIP = void 0;
-const helpers_1 = __importDefault(require("./helpers"));
-const web_1 = require("./web");
-Object.defineProperty(exports, "CheckIP", { enumerable: true, get: function () { return web_1.CheckIP; } });
+exports.ipInfo = void 0;
+exports.getASN = getASN;
+exports.getPrefix = getPrefix;
+const promises_1 = require("dns/promises");
+var web_1 = require("./web");
+Object.defineProperty(exports, "ipInfo", { enumerable: true, get: function () { return web_1.ipInfo; } });
+/** @ignore */
+const sleep = (timeout) => __awaiter(void 0, void 0, void 0, function* () { return new Promise(resolve => setTimeout(resolve, timeout)); });
+/** @ignore */
+const countColons = (value) => {
+    let count = 0;
+    value.replace(/:/g, val => { count++; return val; });
+    return count;
+};
 /**
- * Looks up information regarding the IP address supplied
+ * @ignore
+ * Expands compressed IPv6 address to uncompressed form
  *
- * @param address
+ * @param value
+ */
+const expandIPv6 = (value) => {
+    return value.replace(/::/, () => {
+        return `:${Array((7 - countColons(value)) + 1).join(':')}:`;
+    })
+        .split(':')
+        .map(val => {
+        return Array(4 - val.length).fill('0').join('') + val;
+    })
+        .join(':');
+};
+/**
+ * DNS TXT record resolution with automatic retries
+ *
+ * @param hostname
  * @param max_retries
+ * @param retry
+ * @ignore
  */
-const IPInfo = (address_1, ...args_1) => __awaiter(void 0, [address_1, ...args_1], void 0, function* (address, max_retries = 3) {
-    return helpers_1.default.getPrefix(address, max_retries);
+const getTxtRecord = (hostname_1, ...args_1) => __awaiter(void 0, [hostname_1, ...args_1], void 0, function* (hostname, max_retries = 3, retry = 0) {
+    try {
+        return yield (0, promises_1.resolveTxt)(hostname);
+    }
+    catch (error) {
+        if (error.toString().toLowerCase().includes('refused') && retry < max_retries) {
+            yield sleep(1000);
+            return getTxtRecord(hostname, max_retries, retry);
+        }
+        throw error;
+    }
 });
-exports.IPInfo = IPInfo;
-exports.default = {
-    IPInfo: exports.IPInfo,
-    CheckIP: web_1.CheckIP
-};
+/**
+ * Looks up information on the Autonomous System Number (ASN) via DNS
+ *
+ * @param as
+ * @param max_retries
+ * @ignore
+ */
+function getASN(as_1) {
+    return __awaiter(this, arguments, void 0, function* (as, max_retries = 3) {
+        if (typeof as === 'string') {
+            as = parseInt(as);
+        }
+        const records = yield getTxtRecord(`AS${as}.asn.cymru.com`, max_retries);
+        if (records.length === 0 || records[0].length === 0) {
+            return undefined;
+        }
+        const [, country, registry, allocated, name] = records[0][0].split('|')
+            .map(elem => elem.trim());
+        return {
+            asn: as,
+            country: country.toUpperCase(),
+            registry: registry.toUpperCase(),
+            allocated: new Date(allocated),
+            name: name.split(',')[0]
+        };
+    });
+}
+/**
+ * Looks up the prefix information via DNS
+ *
+ * @param address
+ * @param max_retries
+ * @ignore
+ */
+function getPrefix(address_1) {
+    return __awaiter(this, arguments, void 0, function* (address, max_retries = 3) {
+        const original_address = address;
+        address = address.split('/')[0]; // strip off any CIDR notation
+        if (address.includes(':')) {
+            address = expandIPv6(address);
+            address = address.split(':')
+                .join('')
+                .split('')
+                .reverse()
+                .join('.');
+            address = `${address}.origin6.asn.cymru.com`;
+        }
+        else {
+            address = address.split('.')
+                .reverse()
+                .join('.');
+            address = `${address}.origin.asn.cymru.com`;
+        }
+        const records = yield getTxtRecord(address, max_retries);
+        if (records.length === 0 || records[0].length === 0) {
+            return undefined;
+        }
+        const [asn, prefix, country, registry, allocated] = records[0][0].split('|')
+            .map(elem => elem.trim());
+        return {
+            address: original_address,
+            zone: address,
+            asn: parseInt(asn),
+            prefix,
+            country: country.toUpperCase(),
+            registry: registry.toUpperCase(),
+            allocated: new Date(allocated),
+            as: yield getASN(asn)
+        };
+    });
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,4EAA4E;AAC5E,wEAAwE;AACxE,2DAA2D;AAC3D,EAAE;AACF,iFAAiF;AACjF,kDAAkD;AAClD,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,yEAAyE;AACzE,gFAAgF;AAChF,gFAAgF;AAChF,YAAY;;;;;;;;;;;;;;;AAGZ,wDAAgC;AAChC,+BAAgC;AACvB,wFADA,aAAO,OACA;AAEhB;;;;;GAKG;AACI,MAAM,MAAM,GAAG,uBAGa,EAAE,8DAFjC,OAAe,EACf,WAAW,GAAG,CAAC;IAEf,OAAO,iBAAO,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC,CAAA,CAAC;AALW,QAAA,MAAM,UAKjB;AAEF,kBAAe;IACX,MAAM,EAAN,cAAM;IACN,OAAO,EAAP,aAAO;CACV,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}