plevinjs 0.1.0

package/README.md

@@ -0,0 +1,283 @@
+<div align="center">
+<a href="https://www.npmjs.com/package/plevinjs">
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tn3w/plevin/master/.github/title-dark.png">
+<img src="https://raw.githubusercontent.com/tn3w/plevin/master/.github/title-light.png" width="320" alt="plevin">
+</picture>
+</a>
+
+**Location, network and abuse information for any IP address in one offline file.**<br>
+No API, no rate limit, no lookup leaving the machine — or the browser tab.
+
+![npm](https://img.shields.io/npm/v/plevinjs?color=1868f2)
+![Types](https://img.shields.io/badge/types-included-1868f2)
+![License](https://img.shields.io/badge/license-Apache--2.0-1868f2)
+![Fields](https://img.shields.io/badge/fields-98-6f42c1)
+![Boundaries](https://img.shields.io/badge/boundaries-2.6M-6f42c1)
+![Warm](https://img.shields.io/badge/warm%20lookups-4M%2Fs-2ea043)
+
+</div>
+
+```bash
+npm install plevinjs
+```
+
+```js
+import { Plevin, open } from "plevinjs";
+
+const db = await open("https://plevin.tn3w.dev/db/plevin.plv");
+const found = db.lookup("1.1.1.1");  // string, number, bigint or packed bytes
+```
+
+Always a `Result`, never `undefined`; it throws for anything that is not an address, and
+a number reads as v6 only above `0xffffffff`, so `lookup(1)` is `0.0.0.1`.
+
+```js
+found.place.city.name;                    // 'Brisbane'
+found.place.city.region.name;             // 'Queensland'
+found.place.country.name;                 // 'Australia'
+found.place.time.local;                   // '2026-08-13T23:27:58+10:00'
+
+found.network.asn;                        // 13335
+found.network.operator.brand;             // 'Cloudflare'
+found.network.cidr;                       // '1.1.1.0/24'
+
+const exit = db.lookup("185.220.101.1");
+exit.abuse.service;                       // 'tor_exit_node'
+exit.abuse.risk;                          // 0.97
+exit.abuse.is_tor_exit_node;              // true
+```
+
+Pure ESM with no dependencies, so it runs wherever fetch does: Node, Deno, Bun,
+Cloudflare Workers, and any browser off a CDN.
+
+```html
+<script type="module">
+import { open } from "https://cdn.jsdelivr.net/npm/plevinjs";
+
+const db = await open("https://plevin.tn3w.dev/db/plevin.plv");
+document.title = db.lookup("8.8.8.8").place.country.flag;
+</script>
+```
+
+`https://esm.sh/plevinjs` serves the same thing. Every database is rehosted with open
+CORS at [plevin.tn3w.dev/db](https://plevin.tn3w.dev/db/), because GitHub release
+downloads send no CORS header.
+
+## Where the file comes from
+
+| where it runs | how to open it |
+| --- | --- |
+| browser, worker | `await open(url)`, or `await open(response)` |
+| Node, Deno, Bun | `import { openFile } from "plevinjs/node"`, then `await openFile(path)` |
+| bytes you hold | `new Plevin(bytes)`, taking a `Uint8Array` |
+
+`openFile()` reads `PLEVIN_DB` where no path is given. Nothing is downloaded for you
+and nothing is cached for you: hand the same `Plevin` to every lookup and the file is
+read once.
+
+| file | size | carries |
+| --- | --- | --- |
+| `plevin.plv` | 16.9 MB | every field |
+| `plevin.metro-place.plv` | 6.3 MB | city, region, postal, coordinates, metro |
+| `plevin.abuse-network.plv` | 10.3 MB | ASN, operator, routing, abuse |
+| `plevin.place-country-code.plv` | 423 KB | the country code |
+
+## Every field
+
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tn3w/plevin/master/.github/fields-dark.png">
+<img src="https://raw.githubusercontent.com/tn3w/plevin/master/.github/fields-light.png" width="840" alt="address to place, network and abuse">
+</picture>
+
+`found.place` is where the address is, `found.network` who announces it, `found.abuse`
+what has been seen from it. Any of the three is `null` where the build carries none of
+it, and every leaf is `null` rather than `""` or `0` where a source says nothing. The
+shapes and the field names are the ones the
+[Python package](https://github.com/tn3w/plevin/blob/master/python/README.md#every-field)
+answers with, to the letter.
+
+```js
+{
+  lat: -27.4675, lon: 153.0281, accuracy: 200, confidence: 36,
+  granularity: 'city',
+  city: {
+    id: 2174003, name: 'Brisbane', ascii: 'Brisbane', country: 'AU',
+    population: 2780063, elevation: 27, postal: '4000', postal_partial: null,
+    timezone: 'Australia/Brisbane', type: 'regional capital', capital: 'region',
+    region: { id: 2152274, code: '04', iso: 'AU-QLD', name: 'Queensland',
+              type: 'State' },
+    district: { id: 7839562, code: '31000', name: 'Brisbane' },
+    metro: null,
+  },
+  country: {
+    code: 'AU', name: 'Australia', official: null, common: null, iso3: 'AUS',
+    numeric: '036', flag: '🇦🇺', european_union: false, driving_side: 'left',
+  },
+  time: {
+    timezone: 'Australia/Brisbane', abbreviation: 'AEST',
+    local: '2026-08-13T19:20:00+10:00', utc_offset: '+10:00', is_dst: false,
+    dst_start: null, dst_end: null,
+  },
+}
+```
+
+`country` and `time` are derived, not stored: `country` out of an ISO 3166 table in the
+package, `time` out of the runtime's own `Intl` zone data, so neither needs an install
+and neither is a network call. Where the host's zone data is older or newer than the
+one the Python package reads, a daylight boundary may move by a transition.
+
+```js
+{
+  asn: 13335, handle: 'CLOUDFLARENET', prefix: 24, cidr: '1.1.1.0/24',
+  start: '1.1.1.0', end: '1.1.1.255', rpki: 'valid', roas: 1,
+  operator: {
+    company: 'Cloudflare, Inc.', brand: 'Cloudflare', domain: 'cloudflare.com',
+    website: 'https://www.cloudflare.com', category: 'content', tier: 2,
+    peering: 356, scope: 'Global', rir: 'arin', since: 2010,
+    street: '101 Townsend St', state: 'CA', postal: '94107-1934', country: 'US',
+    abuse_email: 'abuse@cloudflare.com', city: { name: 'San Francisco', ... },
+  },
+  carrier: { user_type: 'hosting', user_count: 19, mcc: null, mnc: null,
+             is_mobile: false },
+}
+```
+
+`cidr` is the announcement the address falls in, masked out of the address itself.
+`rpki` is `valid`, `invalid` or `unknown` and `roas` how many ROAs agree. `brand` drops
+the legal form and the words every network carries, so `GOOGLE` and `Google LLC` both
+read `Google`.
+
+```js
+db.lookup("185.220.101.1").abuse;
+{
+  name: 'Tor', service: 'tor_exit_node', evidence: 'measured', risk: 0.97,
+  network_risk: null, last_seen_days: 1, is_anycast: false, is_satellite: false,
+  is_hosting_provider: true, is_proxy: false, is_public_proxy: false,
+  is_residential_proxy: false, is_anonymous_vpn: false, is_tor_exit_node: true,
+  is_private_relay: false, is_anonymous: true,
+}
+```
+
+`risk` is 0 to 1 for the address, `network_risk` the same for the whole ASN, `null`
+where nothing has ever been seen — which is not a risk of zero.
+
+## What an address says on its own
+
+Answered without the database, so they hold for every address:
+
+```js
+const found = db.lookup("2606:4700::1111");
+found.number;    // 50543257672059871404715951523469725969n
+found.compressed // '2606:4700::1111'
+found.expanded;  // '2606:4700:0000:0000:0000:0000:0000:1111'
+found.arpa;      // '1.1.1.1.0.0.….0.7.4.6.0.6.2.ip6.arpa'
+```
+
+`number` is a `bigint` for v6 and a `number` for v4, so `JSON.stringify` needs a
+replacer where you hand a v6 result on. Then `is_global` and `is_bogon`, `is_private`,
+`is_loopback`, `is_multicast`, `is_reserved`, `is_link_local`, `is_unique_local`,
+`is_documentation`, `is_shared` (100.64/10) and `is_benchmark` (198.18/15), bisected
+out of the IANA special-purpose registries.
+
+```js
+db.lookup("::ffff:8.8.8.8").tunnel;         // 'ipv4-mapped'
+db.lookup("::ffff:8.8.8.8").embedded_ipv4;  // '8.8.8.8'
+db.lookup("2002:808:808::1").is_6to4;       // true
+```
+
+`tunnel` is `ipv4-mapped`, `6to4`, `teredo`, `nat64` or `null`.
+
+## In a browser
+
+No build step and no install: the package is plain ESM with no dependencies, so any npm
+CDN serves it as it is.
+
+```html
+<script type="module">
+  import { open } from "https://cdn.jsdelivr.net/npm/plevinjs";
+
+  const db = await open("https://plevin.tn3w.dev/db/plevin.plv");
+  document.title = db.lookup("1.1.1.1").place.country.flag;
+</script>
+```
+
+| | |
+| --- | --- |
+| `https://cdn.jsdelivr.net/npm/plevinjs` | the published files, as they are |
+| `https://esm.sh/plevinjs` | the same, imports rewritten |
+| `https://unpkg.com/plevinjs` | the same as jsDelivr |
+| `https://plevin.tn3w.dev/plevin/` | the reader beside the databases |
+
+Every module is fetched as published, `./reader.js` and all, so the browser loads the
+ten it needs and nothing more. Pin a version for anything that ships:
+`cdn.jsdelivr.net/npm/plevinjs@0.1.0`. `plevinjs/node` is the only entry that touches
+Node, so a CDN import never reaches for `node:fs`.
+
+18 MB crosses the wire once, so keep it out of the critical path and out of the next
+visit's way:
+
+```js
+const store = await caches.open("plevin");
+const url = "https://plevin.tn3w.dev/db/plevin.plv";
+if (!(await store.match(url))) await store.add(url);
+
+const held = await store.match(url);
+const db = new Plevin(new Uint8Array(await held.arrayBuffer()));
+```
+
+`plevin.place-country-code.plv` is 423 KB where the country code is all a page needs.
+[The lookup page](https://plevin.tn3w.dev/) is the whole idea in one file of
+plain JavaScript: it reads the database in the tab and calls out only for the visitor's
+own address and for hostnames.
+
+## Speed
+
+Measured on the full file, Node 26, one core:
+
+| | |
+| --- | --- |
+| open | 14 ms, the header only |
+| first answer | 44 ms, the blocks it lands in |
+| repeats | 4,600,000/s |
+| uniformly random v4 | 13,000/s cold, 200,000/s over the same log again |
+
+Blocks decode on reach and stay decoded, so a real log lands between the two. Memory is
+the file plus whatever it decoded, around 120 MB of heap with the whole world touched.
+
+## Zstandard
+
+The file is Zstandard with trained dictionaries, which no runtime decompresses on its
+own — `DecompressionStream` has no zstd and Node's `zlib` takes no dictionary. So the
+package carries one, condensed from [fzstd](https://github.com/101arrowz/fzstd) (MIT)
+with the dictionary support it leaves out, and verified block for block against
+libzstd over the whole database.
+
+```js
+import { decompress, loadDictionary } from "plevin/zstd";
+
+decompress(frame);                          // one frame
+decompress(frame, loadDictionary(trained)); // with a trained dictionary
+```
+
+## Development
+
+```bash
+cd js
+npm ci
+npm test          # node --test, no database needed for most of it
+npm run lint      # biome
+npm run typecheck # tsc, strict
+npm run build     # dist/, ESM and .d.ts
+
+node test/compare.ts ../plevin.plv sample.json  # field for field against Python
+node test/blocks.ts ../plevin.plv 100000        # every block against libzstd
+```
+
+## License
+
+Apache 2.0, see [LICENSE](https://github.com/tn3w/plevin/blob/master/LICENSE). The
+database carries the licenses of the sources it was built from, listed in
+[`builder/README.md`](https://github.com/tn3w/plevin/blob/master/builder/README.md#sources).
+
+<!-- brand: Noto Sans 800, wordmark bar #1868f2 place, #6f42c1 network, #2ea043 abuse; #7d8894 address, ink #0b1220 light, #f0f6fc dark -->

package/dist/address.d.ts

@@ -0,0 +1,28 @@
+/** What an address is before any database is opened. */
+export type Value = string | number | bigint | Uint8Array;
+export declare const PRIVATE = 1;
+export declare const LOOPBACK = 2;
+export declare const MULTICAST = 4;
+export declare const RESERVED = 8;
+export declare const LINK_LOCAL = 16;
+export declare const UNIQUE_LOCAL = 32;
+export declare const DOCUMENTATION = 64;
+export declare const SHARED = 128;
+export declare const BENCHMARK = 256;
+export declare const MAPPED = "ipv4-mapped";
+export declare const SIXTOFOUR = "6to4";
+export declare const TEREDO = "teredo";
+export declare const NAT64 = "nat64";
+/** An address however it is written; an integer reads as v6 only above 0xffffffff. */
+export declare const parse: (value: Value) => [number | bigint, boolean];
+/** How the address reads short and in full, and the name a resolver asks by. */
+export declare const spelled: (value: number | bigint, wide: boolean) => [string, string, string];
+/** An address as text: v4 from its octets, v6 through the shortening rules. */
+export declare const written: (value: number | bigint, wide: boolean) => string;
+/** What an address is where it is not the internet, bisected out of the table. */
+export declare const purpose: (value: number | bigint, wide: boolean) => number;
+/** The v4 address a v6 one carries, and the tunnel that puts it there. */
+export declare const tunnel: (value: number | bigint, wide: boolean) => [string | null, string | null];
+/** The announcement the address falls in, masked out of the address itself. */
+export declare const span: (value: number | bigint, wide: boolean, prefix: number) => [string, string, string];
+//# sourceMappingURL=address.d.ts.map

package/dist/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAE1D,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,QAAQ,IAAI,CAAC;AAC1B,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,QAAQ,IAAI,CAAC;AAC1B,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,MAAM,MAAM,CAAC;AAC1B,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B,eAAO,MAAM,MAAM,gBAAgB,CAAC;AACpC,eAAO,MAAM,SAAS,SAAS,CAAC;AAChC,eAAO,MAAM,MAAM,WAAW,CAAC;AAC/B,eAAO,MAAM,KAAK,UAAU,CAAC;AAuF7B,sFAAsF;AACtF,eAAO,MAAM,KAAK,UAAW,KAAK,KAAG,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CA6B7D,CAAC;AA2BF,gFAAgF;AAChF,eAAO,MAAM,OAAO,UACX,MAAM,GAAG,MAAM,QAChB,OAAO,KACZ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CA4BzB,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,OAAO,UAAW,MAAM,GAAG,MAAM,QAAQ,OAAO,KAAG,MACvC,CAAC;AAc1B,kFAAkF;AAClF,eAAO,MAAM,OAAO,UAAW,MAAM,GAAG,MAAM,QAAQ,OAAO,KAAG,MAa/D,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,MAAM,UACV,MAAM,GAAG,MAAM,QAChB,OAAO,KACZ,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,CAW/B,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,IAAI,UACR,MAAM,GAAG,MAAM,QAChB,OAAO,UACL,MAAM,KACb,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAOzB,CAAC"}

package/dist/address.js

@@ -0,0 +1,242 @@
+/** What an address is before any database is opened. */
+export const PRIVATE = 1;
+export const LOOPBACK = 2;
+export const MULTICAST = 4;
+export const RESERVED = 8;
+export const LINK_LOCAL = 16;
+export const UNIQUE_LOCAL = 32;
+export const DOCUMENTATION = 64;
+export const SHARED = 128;
+export const BENCHMARK = 256;
+export const MAPPED = "ipv4-mapped";
+export const SIXTOFOUR = "6to4";
+export const TEREDO = "teredo";
+export const NAT64 = "nat64";
+const V4_MAX = 0xffffffff;
+const V6_MAX = (1n << 128n) - 1n;
+const SPECIAL_V4 = [
+    ["0.0.0.0/8", RESERVED],
+    ["10.0.0.0/8", PRIVATE],
+    ["100.64.0.0/10", PRIVATE | SHARED],
+    ["127.0.0.0/8", PRIVATE | LOOPBACK],
+    ["169.254.0.0/16", PRIVATE | LINK_LOCAL],
+    ["172.16.0.0/12", PRIVATE],
+    ["192.0.0.0/24", RESERVED],
+    ["192.0.2.0/24", RESERVED | DOCUMENTATION],
+    ["192.88.99.0/24", RESERVED],
+    ["192.168.0.0/16", PRIVATE],
+    ["198.18.0.0/15", RESERVED | BENCHMARK],
+    ["198.51.100.0/24", RESERVED | DOCUMENTATION],
+    ["203.0.113.0/24", RESERVED | DOCUMENTATION],
+    ["224.0.0.0/4", MULTICAST],
+    ["240.0.0.0/4", RESERVED],
+];
+const SPECIAL_V6 = [
+    ["::/128", RESERVED],
+    ["::1/128", PRIVATE | LOOPBACK],
+    ["::ffff:0:0/96", RESERVED],
+    ["64:ff9b::/96", RESERVED],
+    ["64:ff9b:1::/48", RESERVED],
+    ["100::/64", RESERVED],
+    ["2001::/23", RESERVED],
+    ["2001:db8::/32", RESERVED | DOCUMENTATION],
+    ["2002::/16", RESERVED],
+    ["3fff::/20", RESERVED | DOCUMENTATION],
+    ["fc00::/7", PRIVATE | UNIQUE_LOCAL],
+    ["fe80::/10", PRIVATE | LINK_LOCAL],
+    ["ff00::/8", MULTICAST],
+];
+const OCTET = /^(0|[1-9][0-9]{0,2})$/;
+const GROUP = /^[0-9a-fA-F]{1,4}$/;
+const parseV4 = (text) => {
+    const parts = text.split(".");
+    if (parts.length !== 4)
+        return null;
+    let value = 0;
+    for (const part of parts) {
+        if (!OCTET.test(part))
+            return null;
+        const octet = Number(part);
+        if (octet > 255)
+            return null;
+        value = value * 256 + octet;
+    }
+    return value;
+};
+const groups = (text, expected) => {
+    if (text === "")
+        return [];
+    const parts = text.split(":");
+    const held = [];
+    for (let index = 0; index < parts.length; index += 1) {
+        const part = parts[index];
+        if (index === parts.length - 1 && part.includes(".")) {
+            const embedded = parseV4(part);
+            if (embedded === null)
+                return null;
+            held.push(embedded >>> 16, embedded & 0xffff);
+            continue;
+        }
+        if (!GROUP.test(part))
+            return null;
+        held.push(Number.parseInt(part, 16));
+    }
+    return held.length <= expected ? held : null;
+};
+const parseV6 = (text) => {
+    const sides = text.split("::");
+    if (sides.length > 2)
+        return null;
+    const head = groups(sides[0], 8);
+    const tail = sides.length === 2 ? groups(sides[1], 8) : [];
+    if (head === null || tail === null)
+        return null;
+    const held = head.length + tail.length;
+    if (sides.length === 1 ? held !== 8 : held > 7)
+        return null;
+    const all = [...head, ...Array(8 - held).fill(0), ...tail];
+    let value = 0n;
+    for (const group of all)
+        value = (value << 16n) | BigInt(group);
+    return value;
+};
+/** An address however it is written; an integer reads as v6 only above 0xffffffff. */
+export const parse = (value) => {
+    if (typeof value === "string") {
+        if (value.includes(":")) {
+            const wide = parseV6(value);
+            if (wide === null)
+                throw new Error(`${value} is not an address`);
+            return [wide, true];
+        }
+        const narrow = parseV4(value);
+        if (narrow === null)
+            throw new Error(`${value} is not an address`);
+        return [narrow, false];
+    }
+    if (value instanceof Uint8Array) {
+        if (value.length === 4) {
+            return [
+                ((value[0] << 24) >>> 0) + (value[1] << 16) + (value[2] << 8) + value[3],
+                false,
+            ];
+        }
+        if (value.length !== 16)
+            throw new Error("packed addresses are 4 or 16 bytes");
+        let held = 0n;
+        for (const byte of value)
+            held = (held << 8n) | BigInt(byte);
+        return [held, true];
+    }
+    if (typeof value !== "bigint" && !Number.isInteger(value)) {
+        throw new Error(`${String(value)} is not an address`);
+    }
+    const number = typeof value === "bigint" ? value : BigInt(value);
+    if (number < 0n || number > V6_MAX)
+        throw new Error(`${value} is not an address`);
+    return number > BigInt(V4_MAX) ? [number, true] : [Number(number), false];
+};
+const hextets = (value) => Array.from({ length: 8 }, (_, index) => Number((value >> BigInt(112 - index * 16)) & 0xffffn));
+const dotted = (value) => [24, 16, 8, 0].map((shift) => (value >>> shift) & 255).join(".");
+const shortest = (parts, held) => {
+    let bestAt = -1;
+    let bestRun = 1;
+    let at = -1;
+    for (let index = 0; index <= held.length; index += 1) {
+        if (held[index] === 0 && at < 0)
+            at = index;
+        if ((held[index] !== 0 || index === held.length) && at >= 0) {
+            if (index - at > bestRun)
+                [bestAt, bestRun] = [at, index - at];
+            at = -1;
+        }
+    }
+    if (bestAt < 0)
+        return parts.join(":");
+    const head = parts.slice(0, bestAt).join(":");
+    const tail = parts.slice(bestAt + bestRun).join(":");
+    return `${head}::${tail}`;
+};
+/** How the address reads short and in full, and the name a resolver asks by. */
+export const spelled = (value, wide) => {
+    if (!wide) {
+        const text = dotted(value);
+        const octets = text.split(".");
+        return [text, text, `${[...octets].reverse().join(".")}.in-addr.arpa`];
+    }
+    const held = hextets(value);
+    const nibbles = value.toString(16).padStart(32, "0");
+    const arpa = `${[...nibbles].reverse().join(".")}.ip6.arpa`;
+    const mapped = held.slice(0, 5).every((group) => group === 0) && held[5] === 0xffff;
+    if (mapped) {
+        const quad = dotted(Number(value & 0xffffffffn));
+        const parts = held.slice(0, 6).map((group) => group.toString(16));
+        const full = held.slice(0, 6).map((group) => group.toString(16).padStart(4, "0"));
+        return [
+            `${shortest(parts, held.slice(0, 6))}:${quad}`,
+            `${full.join(":")}:${quad}`,
+            arpa,
+        ];
+    }
+    return [
+        shortest(held.map((group) => group.toString(16)), held),
+        held.map((group) => group.toString(16).padStart(4, "0")).join(":"),
+        arpa,
+    ];
+};
+/** An address as text: v4 from its octets, v6 through the shortening rules. */
+export const written = (value, wide) => spelled(value, wide)[0];
+const table = (rows, wide) => rows
+    .map(([text, marks]) => {
+    const [network, bits] = text.split("/");
+    const first = BigInt(parse(network)[0]);
+    const spare = BigInt((wide ? 128 : 32) - Number(bits));
+    return [first, first + ((1n << spare) - 1n), marks];
+})
+    .sort((left, right) => (left[0] < right[0] ? -1 : 1));
+const SPECIAL = [table(SPECIAL_V4, false), table(SPECIAL_V6, true)];
+/** What an address is where it is not the internet, bisected out of the table. */
+export const purpose = (value, wide) => {
+    const rows = SPECIAL[wide ? 1 : 0];
+    const held = BigInt(value);
+    let low = 0;
+    let high = rows.length;
+    while (low < high) {
+        const middle = (low + high) >> 1;
+        if (rows[middle][0] <= held)
+            low = middle + 1;
+        else
+            high = middle;
+    }
+    const found = rows[low - 1];
+    if (found && held <= found[1])
+        return found[2];
+    return wide && held >> 125n !== 1n ? RESERVED : 0;
+};
+/** The v4 address a v6 one carries, and the tunnel that puts it there. */
+export const tunnel = (value, wide) => {
+    if (!wide)
+        return [null, null];
+    const held = value;
+    const low = Number(held & 0xffffffffn);
+    if (held >> 32n === 0xffffn)
+        return [MAPPED, dotted(low)];
+    if (held >> 112n === 0x2002n) {
+        return [SIXTOFOUR, dotted(Number((held >> 80n) & 0xffffffffn))];
+    }
+    if (held >> 96n === 0x20010000n)
+        return [TEREDO, dotted(~low >>> 0)];
+    if (held >> 32n === 0x0064ff9bn << 64n)
+        return [NAT64, dotted(low)];
+    return [null, null];
+};
+/** The announcement the address falls in, masked out of the address itself. */
+export const span = (value, wide, prefix) => {
+    const spare = BigInt((wide ? 128 : 32) - prefix);
+    const held = BigInt(value);
+    const first = (held >> spare) << spare;
+    const last = held | ((1n << spare) - 1n);
+    const start = written(wide ? first : Number(first), wide);
+    return [`${start}/${prefix}`, start, written(wide ? last : Number(last), wide)];
+};
+//# sourceMappingURL=address.js.map

package/dist/address.js.map

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

package/dist/countries.d.ts

@@ -0,0 +1,3 @@
+/** ISO 3166 as one string: code, iso3, numeric, name and any official or common name. */
+export declare const COUNTRIES: string[];
+//# sourceMappingURL=countries.d.ts.map

package/dist/countries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countries.d.ts","sourceRoot":"","sources":["../src/countries.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAEzF,eAAO,MAAM,SAAS,UA4PR,CAAC"}