plevinjs 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/** Location, network and abuse information for any IP address in one offline file. */
+import { type Value } from "./address.ts";
+import type { Result } from "./models.ts";
+import { File, type Row } from "./reader.ts";
+export type { Value } from "./address.ts";
+export * from "./models.ts";
+export { File } from "./reader.ts";
+export { decompress, loadDictionary } from "./zstd.ts";
+/** One database, opened once and asked as often as a log has addresses. */
+export declare class Plevin {
+    readonly file: File;
+    private readonly kept;
+    private readonly results;
+    private second;
+    constructor(bytes: Uint8Array);
+    get built(): string;
+    get selection(): string;
+    get fields(): string[];
+    private storedFor;
+    /** One address, however it is written, as everything the file answers. */
+    lookup(value: Value, moment?: Date | null): Result;
+    /** The stored rows without any shaping, or null where the file covers nothing. */
+    row(value: Value): Row | null;
+}
+/** A database read over the network, in a browser, a worker or on a server. */
+export declare const open: (source: string | URL | Request | Response | ArrayBuffer | Uint8Array) => Promise<Plevin>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAkBL,KAAK,KAAK,EACX,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAUV,MAAM,EACP,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,IAAI,EAAc,KAAK,GAAG,EAAE,MAAM,aAAa,CAAC;AAEzD,YAAY,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AA+OvD,2EAA2E;AAC3E,qBAAa,MAAM;IACjB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,MAAM,CAAK;IAEnB,YAAY,KAAK,EAAE,UAAU,EAE5B;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,MAAM,IAAI,MAAM,EAAE,CAErB;IAED,OAAO,CAAC,SAAS;IAUjB,0EAA0E;IAC1E,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAmBjD;IAED,kFAAkF;IAClF,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,GAAG,IAAI,CAG5B;CACF;AAED,+EAA+E;AAC/E,eAAO,MAAM,IAAI,WACP,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,KACnE,OAAO,CAAC,MAAM,CAMhB,CAAC"}

package/dist/index.js

@@ -0,0 +1,282 @@
+/** Location, network and abuse information for any IP address in one offline file. */
+import { BENCHMARK, DOCUMENTATION, LINK_LOCAL, LOOPBACK, MAPPED, MULTICAST, PRIVATE, parse, purpose, RESERVED, SHARED, SIXTOFOUR, span, spelled, TEREDO, tunnel, UNIQUE_LOCAL, } from "./address.js";
+import * as derive from "./derive.js";
+import { clock, country } from "./extra.js";
+import { File } from "./reader.js";
+export * from "./models.js";
+export { File } from "./reader.js";
+export { decompress, loadDictionary } from "./zstd.js";
+const ANSWERED = 1 << 10;
+const WIDE = 1n << 128n;
+const text = (value) => (value ? String(value) : null);
+const count = (value) => (value ? Number(value) : null);
+const number = (value) => value === undefined || value === null ? null : Number(value);
+const held = (row, field) => row?.[field];
+const metro = (row) => row ? { code: count(row.code), label: text(row.label) } : null;
+const district = (row) => row ? { id: count(row.id), code: text(row.code), name: text(row.name) } : null;
+const region = (row) => row
+    ? {
+        id: count(row.id),
+        code: text(row.code),
+        iso: text(row.iso),
+        name: text(row.name),
+        type: text(row.type),
+    }
+    : null;
+/** One model per row object the file hands back, and the file hands back one. */
+const shaped = (build) => {
+    const kept = new WeakMap();
+    return (row, ...rest) => {
+        if (!row)
+            return null;
+        const key = rest.join("\n");
+        let held = kept.get(row);
+        if (!held) {
+            held = new Map();
+            kept.set(row, held);
+        }
+        const found = held.get(key);
+        if (found !== undefined)
+            return found;
+        const built = build(row, ...rest);
+        held.set(key, built);
+        return built;
+    };
+};
+const city = shaped((row) => {
+    const kind = String(row.type ?? "");
+    return {
+        id: count(row.id),
+        name: text(row.name),
+        ascii: text(row.ascii),
+        country: text(row.country),
+        population: count(row.population),
+        elevation: count(row.elevation),
+        postal: text(row.postal),
+        postal_partial: text(row.postal_partial),
+        timezone: text(row.timezone),
+        type: text(kind),
+        capital: text(derive.capital(kind)),
+        region: region(held(row, "region")),
+        district: district(held(row, "district")),
+        metro: metro(held(row, "metro")),
+    };
+});
+const operator = shaped((row, handle) => {
+    const company = String(row.company ?? "");
+    const website = String(row.website ?? "");
+    const mailbox = String(row.abuse_email ?? "");
+    return {
+        company: text(company),
+        brand: text(derive.brand(handle, company)),
+        domain: text(derive.domain(website, mailbox)),
+        website: text(website),
+        category: text(row.category),
+        tier: count(row.tier),
+        peering: count(row.peering),
+        scope: text(row.scope),
+        rir: text(row.rir),
+        since: count(row.since),
+        street: text(row.street),
+        state: text(row.state),
+        postal: text(row.postal),
+        country: text(row.country),
+        abuse_email: text(mailbox),
+        city: city(held(row, "city")),
+    };
+});
+const carrier = (row, userType) => {
+    if (!row && !userType)
+        return null;
+    const found = row ?? {};
+    return {
+        user_type: text(userType),
+        user_count: count(found.user_count),
+        mcc: count(found.mcc),
+        mnc: count(found.mnc),
+        is_mobile: userType === "cellular",
+    };
+};
+const abuseOf = (record, system, userType) => {
+    if (!record && !system)
+        return null;
+    const found = record ?? {};
+    const [named, inferred] = derive.service(String(found.service ?? ""), userType);
+    return {
+        name: text(found.name),
+        service: text(named),
+        evidence: text(String(found.evidence ?? "") || inferred),
+        risk: number(found.risk),
+        network_risk: system ? number(system.risk) : null,
+        last_seen_days: count(found.last_seen_days),
+        is_anycast: Boolean(found.is_anycast),
+        is_satellite: Boolean(found.is_satellite),
+        is_hosting_provider: derive.SERVERS.has(userType),
+        is_proxy: derive.PROXIES.has(named),
+        is_public_proxy: named === "public_proxy",
+        is_residential_proxy: named === "residential_proxy",
+        is_anonymous_vpn: named === "anonymous_vpn",
+        is_tor_exit_node: named === "tor_exit_node",
+        is_private_relay: named === "private_relay",
+        is_anonymous: Boolean(named),
+    };
+};
+/** The place without its clock, which is the one part an address does not fix. */
+const place = (row) => {
+    if (!row)
+        return null;
+    const found = city(held(row, "city"));
+    const code = found?.country ?? "";
+    const zone = found?.timezone ?? "";
+    return [
+        {
+            lat: number(row.lat),
+            lon: number(row.lon),
+            accuracy: count(row.accuracy),
+            confidence: count(row.confidence),
+            granularity: text(row.granularity),
+            city: found,
+            country: country(code),
+        },
+        zone,
+    ];
+};
+/** The network without its span, which the address the lookup asked about fixes. */
+const network = (row, userType) => {
+    if (!row)
+        return null;
+    const handle = String(row.handle ?? "");
+    return [
+        {
+            asn: count(row.asn),
+            handle: text(handle),
+            rpki: text(row.rpki),
+            roas: number(row.roas),
+            operator: operator(held(row, "operator"), handle),
+            carrier: carrier(held(row, "carrier"), userType),
+        },
+        count(row.prefix),
+    ];
+};
+/** The ASN's type sits on the system row; the record carries only an override. */
+const userTypeOf = (record, system) => String(record?.user_type || system?.user_type || "");
+/** Everything a boundary answers that no address of it changes, built once. */
+const stored = (row) => {
+    const wires = held(row, "network");
+    const system = held(wires, "abuse");
+    const userType = userTypeOf(held(row, "abuse"), system);
+    return [
+        place(held(row, "place")),
+        network(wires, userType),
+        abuseOf(held(row, "abuse"), system, userType),
+    ];
+};
+const spanned = (wires, value, wide) => {
+    const [held, prefix] = wires;
+    const [cidr, start, end] = prefix === null ? [null, null, null] : span(value, wide, prefix);
+    return { ...held, prefix, cidr, start, end };
+};
+const result = (value, wide, found, moment) => {
+    const [compressed, expanded, arpa] = spelled(value, wide);
+    const marks = purpose(value, wide);
+    const [through, embedded] = tunnel(value, wide);
+    const [ground, wires, abuse] = found ?? [null, null, null];
+    return {
+        ip: compressed,
+        version: wide ? 6 : 4,
+        number: value,
+        compressed,
+        expanded,
+        arpa,
+        is_global: marks === 0,
+        is_bogon: marks !== 0,
+        is_private: (marks & PRIVATE) !== 0,
+        is_loopback: (marks & LOOPBACK) !== 0,
+        is_multicast: (marks & MULTICAST) !== 0,
+        is_reserved: (marks & RESERVED) !== 0,
+        is_link_local: (marks & LINK_LOCAL) !== 0,
+        is_unique_local: (marks & UNIQUE_LOCAL) !== 0,
+        is_documentation: (marks & DOCUMENTATION) !== 0,
+        is_shared: (marks & SHARED) !== 0,
+        is_benchmark: (marks & BENCHMARK) !== 0,
+        is_ipv4_mapped: through === MAPPED,
+        is_6to4: through === SIXTOFOUR,
+        is_teredo: through === TEREDO,
+        tunnel: through,
+        embedded_ipv4: embedded,
+        found: found !== null,
+        place: ground === null ? null : { ...ground[0], time: clock(ground[1], moment) },
+        network: wires === null ? null : spanned(wires, value, wide),
+        abuse,
+    };
+};
+/** One database, opened once and asked as often as a log has addresses. */
+export class Plevin {
+    file;
+    kept = new Map();
+    results = new Map();
+    second = 0;
+    constructor(bytes) {
+        this.file = new File(bytes);
+    }
+    get built() {
+        return this.file.built;
+    }
+    get selection() {
+        return this.file.selection;
+    }
+    get fields() {
+        return this.file.fields;
+    }
+    storedFor(found) {
+        const key = found.join(",");
+        const held = this.kept.get(key);
+        if (held !== undefined)
+            return held;
+        if (this.kept.size >= ANSWERED * 16)
+            this.kept.clear();
+        const built = stored(this.file.answerFor(found));
+        this.kept.set(key, built);
+        return built;
+    }
+    /** One address, however it is written, as everything the file answers. */
+    lookup(value, moment) {
+        const [held, wide] = parse(value);
+        if (moment) {
+            const found = this.file.locate(held, wide);
+            return result(held, wide, found && this.storedFor(found), moment);
+        }
+        const second = Math.floor(Date.now() / 1000);
+        if (second !== this.second) {
+            this.second = second;
+            this.results.clear();
+        }
+        const key = wide ? held + WIDE : BigInt(held);
+        const answered = this.results.get(key);
+        if (answered !== undefined)
+            return answered;
+        if (this.results.size >= ANSWERED)
+            this.results.clear();
+        const found = this.file.locate(held, wide);
+        const built = result(held, wide, found && this.storedFor(found));
+        this.results.set(key, built);
+        return built;
+    }
+    /** The stored rows without any shaping, or null where the file covers nothing. */
+    row(value) {
+        const [held, wide] = parse(value);
+        return this.file.rowFor(held, wide);
+    }
+}
+/** A database read over the network, in a browser, a worker or on a server. */
+export const open = async (source) => {
+    if (source instanceof Uint8Array)
+        return new Plevin(source);
+    if (source instanceof ArrayBuffer)
+        return new Plevin(new Uint8Array(source));
+    const response = source instanceof Response ? source : await fetch(source);
+    if (!response.ok)
+        throw new Error(`${response.status} reading the database`);
+    return new Plevin(new Uint8Array(await response.arrayBuffer()));
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/models.d.ts

@@ -0,0 +1,148 @@
+/** The shapes a lookup answers with; one is shared by every read of a row. */
+export type Metro = {
+    code: number | null;
+    label: string | null;
+};
+export type District = {
+    id: number | null;
+    code: string | null;
+    name: string | null;
+};
+export type Region = {
+    id: number | null;
+    code: string | null;
+    iso: string | null;
+    name: string | null;
+    type: string | null;
+};
+export type City = {
+    id: number | null;
+    name: string | null;
+    ascii: string | null;
+    country: string | null;
+    population: number | null;
+    elevation: number | null;
+    postal: string | null;
+    postal_partial: string | null;
+    timezone: string | null;
+    type: string | null;
+    capital: string | null;
+    region: Region | null;
+    district: District | null;
+    metro: Metro | null;
+};
+export type Country = {
+    code: string | null;
+    name: string | null;
+    official: string | null;
+    common: string | null;
+    iso3: string | null;
+    numeric: string | null;
+    flag: string | null;
+    european_union: boolean;
+    driving_side: string | null;
+};
+export type Time = {
+    timezone: string | null;
+    abbreviation: string | null;
+    local: string | null;
+    utc_offset: string | null;
+    is_dst: boolean;
+    dst_start: string | null;
+    dst_end: string | null;
+};
+export type Place = {
+    lat: number | null;
+    lon: number | null;
+    accuracy: number | null;
+    confidence: number | null;
+    granularity: string | null;
+    city: City | null;
+    country: Country | null;
+    time: Time | null;
+};
+export type Operator = {
+    company: string | null;
+    brand: string | null;
+    domain: string | null;
+    website: string | null;
+    category: string | null;
+    tier: number | null;
+    peering: number | null;
+    scope: string | null;
+    rir: string | null;
+    since: number | null;
+    street: string | null;
+    state: string | null;
+    postal: string | null;
+    country: string | null;
+    abuse_email: string | null;
+    city: City | null;
+};
+export type Carrier = {
+    user_type: string | null;
+    user_count: number | null;
+    mcc: number | null;
+    mnc: number | null;
+    is_mobile: boolean;
+};
+export type Abuse = {
+    name: string | null;
+    service: string | null;
+    evidence: string | null;
+    risk: number | null;
+    network_risk: number | null;
+    last_seen_days: number | null;
+    is_anycast: boolean;
+    is_satellite: boolean;
+    is_hosting_provider: boolean;
+    is_proxy: boolean;
+    is_public_proxy: boolean;
+    is_residential_proxy: boolean;
+    is_anonymous_vpn: boolean;
+    is_tor_exit_node: boolean;
+    is_private_relay: boolean;
+    is_anonymous: boolean;
+};
+export type Network = {
+    asn: number | null;
+    handle: string | null;
+    prefix: number | null;
+    cidr: string | null;
+    start: string | null;
+    end: string | null;
+    rpki: string | null;
+    roas: number | null;
+    operator: Operator | null;
+    carrier: Carrier | null;
+};
+/** One address: what it says on its own, and what the database stores for it. */
+export type Result = {
+    ip: string;
+    version: number;
+    number: number | bigint;
+    compressed: string;
+    expanded: string;
+    arpa: string;
+    is_global: boolean;
+    is_bogon: boolean;
+    is_private: boolean;
+    is_loopback: boolean;
+    is_multicast: boolean;
+    is_reserved: boolean;
+    is_link_local: boolean;
+    is_unique_local: boolean;
+    is_documentation: boolean;
+    is_shared: boolean;
+    is_benchmark: boolean;
+    is_ipv4_mapped: boolean;
+    is_6to4: boolean;
+    is_teredo: boolean;
+    tunnel: string | null;
+    embedded_ipv4: string | null;
+    found: boolean;
+    place: Place | null;
+    network: Network | null;
+    abuse: Abuse | null;
+};
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

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

package/dist/models.js

@@ -0,0 +1,3 @@
+/** The shapes a lookup answers with; one is shared by every read of a row. */
+export {};
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA,8EAA8E"}

package/dist/node.d.ts

@@ -0,0 +1,6 @@
+/** Opening a database from disk, for Node, Deno and Bun. */
+import { Plevin } from "./index.ts";
+export * from "./index.ts";
+/** One database read off disk, or from PLEVIN_DB where no path is given. */
+export declare const openFile: (path?: string) => Promise<Plevin>;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAG5D,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,cAAc,YAAY,CAAC;AAE3B,4EAA4E;AAC5E,eAAO,MAAM,QAAQ,UAAiB,MAAM,KAAG,OAAO,CAAC,MAAM,CAI5D,CAAC"}

package/dist/node.js

@@ -0,0 +1,12 @@
+/** Opening a database from disk, for Node, Deno and Bun. */
+import { readFile } from "node:fs/promises";
+import { Plevin } from "./index.js";
+export * from "./index.js";
+/** One database read off disk, or from PLEVIN_DB where no path is given. */
+export const openFile = async (path) => {
+    const found = path ?? process.env.PLEVIN_DB;
+    if (!found)
+        throw new Error("no database given: pass a path or set PLEVIN_DB");
+    return new Plevin(new Uint8Array(await readFile(found)));
+};
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,cAAc,YAAY,CAAC;AAE3B,4EAA4E;AAC5E,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,IAAa,EAAmB,EAAE;IAC/D,MAAM,KAAK,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IAC5C,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAC/E,OAAO,IAAI,MAAM,CAAC,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC,CAAC"}

package/dist/reader.d.ts

@@ -0,0 +1,85 @@
+/** The file format: one address in, the stored rows out, codes as words. */
+import { type Dictionary } from "./zstd.ts";
+export type Row = Record<string, unknown>;
+export type Found = [number, number, number];
+type Entry = {
+    count: number;
+    read: string;
+    block: number;
+    group: number;
+    offset: number;
+    bytes: number;
+    encoding: string;
+};
+type Head = {
+    built: string;
+    selection: string;
+    fields: string[];
+    sections: Record<string, Entry>;
+    vocabularies: Record<string, string[]>;
+};
+type Read = (value: number) => unknown;
+declare class Cache<Key, Held> {
+    private held;
+    private build;
+    private limit;
+    constructor(build: (key: Key) => Held, limit?: number);
+    get(key: Key): Held;
+    clear(): void;
+}
+/** A block is what the codec packed; a group is all of one a lookup decodes. */
+declare class Section {
+    readonly count: number;
+    readonly read: string;
+    readonly perBlock: number;
+    readonly perGroup: number;
+    readonly fanout: number;
+    readonly width: number;
+    readonly blocks: number;
+    readonly keys: bigint[];
+    protected readonly offsets: Uint32Array;
+    protected readonly data: Uint8Array;
+    protected readonly dictionary: Dictionary | null;
+    protected readonly cache: Cache<number, never>;
+    protected readonly groups: Cache<number, never>;
+    constructor(view: Uint8Array, entry: Entry);
+    protected raw(index: number): Uint8Array;
+    protected held(group: number): number;
+    protected block(index: number): unknown;
+    protected values(group: number): unknown;
+    at(row: number): unknown;
+}
+/** The database in memory, read a group at a time. */
+export declare class File {
+    readonly head: Head;
+    readonly sections: Record<string, Section>;
+    readonly reads: Record<string, Read>;
+    private readonly tables;
+    private readonly families;
+    private readonly rows;
+    private readonly located;
+    private readonly answers;
+    constructor(bytes: Uint8Array);
+    /** A row of a table, kept: a city is read once however many link to it. */
+    private linked;
+    get built(): string;
+    get selection(): string;
+    get fields(): string[];
+    /** Each table's columns split by how they decode, so a read never branches. */
+    private plan;
+    /** The index a lookup bisects, the columns read at that row, and the hosts. */
+    private family;
+    private row;
+    /** The columns the boundary reads, cached by the row rather than its values. */
+    private answer;
+    /** Which boundary answers, and the record a host overrides it with. */
+    private locateIn;
+    /** Which boundary and host record answer, kept so a repeat never bisects. */
+    locate(value: number | bigint, wide: boolean): Found | null;
+    /** The stored answer, or null where the file covers nothing; do not edit it. */
+    rowFor(value: number | bigint, wide: boolean): Row | null;
+    /** One boundary as the file stores it, shared by every address it covers. */
+    answerFor(found: Found): Row;
+}
+export {};
+//# sourceMappingURL=reader.d.ts.map

package/dist/reader.d.ts.map

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