@graphty/graph-io 0.3.47 → 0.3.49

package/dist/src/sources/cypher/descriptor.js

@@ -0,0 +1,124 @@
+/**
+ * The descriptors of the Cypher source and its presets: catalog data, available without loading
+ * the sources' code.
+ */
+/** The parameters every Cypher source shares. */
+const CYPHER_PARAMS = [
+    { name: "query", plainName: "Query", type: "query", language: "cypher" },
+    {
+        name: "mode",
+        plainName: "Mode",
+        type: "enum",
+        values: [
+            { value: "query", label: "Query" },
+            { value: "all", label: "Everything" },
+            { value: "neighborhood", label: "Neighborhood" },
+        ],
+    },
+    { name: "ids", plainName: "Seed ids", type: "node-id" },
+    { name: "depth", plainName: "Depth", type: "integer", default: 1, min: 1, max: 10 },
+    { name: "labels", plainName: "Labels", type: "string", role: "filter", advanced: true },
+    { name: "relationshipTypes", plainName: "Relationship types", type: "string", role: "filter", advanced: true },
+    { name: "idProperty", plainName: "Id property", type: "string", advanced: true },
+    { name: "database", plainName: "Database", type: "string" },
+    {
+        name: "long",
+        plainName: "Large integers",
+        type: "enum",
+        advanced: true,
+        values: [
+            { value: "f64", label: "Number" },
+            { value: "string", label: "Text" },
+        ],
+    },
+    { name: "countFirst", plainName: "Count first", type: "boolean", advanced: true },
+    { name: "pageSize", plainName: "Page size", type: "integer", default: 1000, min: 1, max: 100000, advanced: true },
+];
+/** What every Cypher source can do: expand, probe, validate, and page a capped load. */
+const CYPHER_FEATURES = ["expand", "probe", "validate", "page"];
+/** The transport parameter of the generic source. */
+const TRANSPORT_PARAM = {
+    name: "transport",
+    plainName: "Transport",
+    type: "enum",
+    values: [
+        { value: "query-api", label: "Neo4j Query API" },
+        { value: "bolt", label: "Bolt" },
+        { value: "neptune-https", label: "Neptune Database" },
+        { value: "neptune-analytics", label: "Neptune Analytics" },
+    ],
+};
+/**
+ * The descriptor of the generic `cypher` source. Experimental.
+ * @category Network sources
+ */
+export const CYPHER_DESCRIPTOR = Object.freeze({
+    plainName: "Cypher database",
+    kind: "database",
+    version: 1,
+    auth: ["basic", "bearer", "aws-sigv4"],
+    authRequired: "optional",
+    features: CYPHER_FEATURES,
+    params: [...CYPHER_PARAMS, TRANSPORT_PARAM],
+});
+/**
+ * The descriptor of the `neo4j` preset. Experimental.
+ * @category Network sources
+ */
+export const NEO4J_DESCRIPTOR = Object.freeze({
+    plainName: "Neo4j",
+    kind: "database",
+    version: 1,
+    auth: ["basic", "bearer"],
+    authRequired: "optional",
+    features: CYPHER_FEATURES,
+    params: [
+        ...CYPHER_PARAMS,
+        {
+            // no default: a bolt: or bolt+s: endpoint picks Bolt, any other the Query API
+            ...TRANSPORT_PARAM,
+            values: TRANSPORT_PARAM.values?.filter((v) => v.value === "query-api" || v.value === "bolt"),
+        },
+    ],
+    samples: [
+        {
+            id: "neo4j-movies",
+            plainName: "Neo4j demo: movies",
+            endpoint: "https://demo.neo4jlabs.com:7473",
+            params: { database: "movies", mode: "all" },
+            publicLogin: { username: "movies", password: "movies" }, // NOSONAR(S2068): the public login Neo4j publishes for its demo server
+            counts: { nodes: 171, edges: 253 },
+        },
+        {
+            id: "hetionet",
+            plainName: "Hetionet",
+            endpoint: "bolt+s://neo4j.het.io:7687",
+            params: { transport: "bolt", mode: "neighborhood", idProperty: "name", ids: ["Metformin"], depth: 1 },
+            counts: { nodes: 47031, edges: 2250197 },
+            whole: false,
+        },
+    ],
+});
+/**
+ * The descriptor of the `neptune` preset. Experimental.
+ * @category Network sources
+ */
+export const NEPTUNE_DESCRIPTOR = Object.freeze({
+    plainName: "Amazon Neptune",
+    kind: "database",
+    version: 1,
+    auth: ["aws-sigv4"],
+    authRequired: "optional",
+    features: CYPHER_FEATURES,
+    params: [
+        ...CYPHER_PARAMS,
+        {
+            // no default: a neptune-graph host picks Neptune Analytics, any other Neptune Database
+            ...TRANSPORT_PARAM,
+            values: TRANSPORT_PARAM.values?.filter((v) => v.value.startsWith("neptune")),
+        },
+    ],
+    // Neptune sends no CORS headers (Database), or is not shown to (Analytics)
+    runtimes: { browser: { supported: false, reason: "cors" }, worker: { supported: false, reason: "cors" } },
+});
+//# sourceMappingURL=descriptor.js.map

package/dist/src/sources/cypher/descriptor.js.map

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

package/dist/src/sources/cypher/flatten.d.ts

@@ -0,0 +1,72 @@
+/**
+ * The one result flattener of the Cypher source (design section 5): every node and relationship a
+ * result holds -- in a column, a path, a list or a map -- is collected once by its element id, and
+ * written to the sink as nodes (labels in the `labels` column, as the neo4j CSV importer has them)
+ * and directed edges (type in `type`, element id in `id`). A result of scalars only is
+ * E_SOURCE_NOT_A_GRAPH.
+ */
+import { type GraphSink } from "@graphty/graph-format";
+import { type ImportReportBuilder } from "../../common/report.js";
+import { GraphNode, GraphRel } from "./types-map.js";
+/** One query's result, every value already mapped. */
+export interface QueryResult {
+    /** The column names. */
+    readonly fields: readonly string[];
+    /** The rows, one value per column. */
+    readonly rows: readonly (readonly unknown[])[];
+}
+/** The nodes, relationships and degree hints of one or more results, each once. */
+export declare class Collector {
+    readonly nodes: Map<string, GraphNode>;
+    readonly rels: Map<string, GraphRel>;
+    /** Degree hints by the id expression's value, as text. */
+    readonly degrees: Map<string, number>;
+    /**
+     * Collect a result.
+     * @param result - the result
+     * @param hints - whether its `key` / `degree` / `degrees` columns are the generated queries' hints
+     */
+    add(result: QueryResult, hints: boolean): void;
+    /**
+     * Collect every node and relationship inside a value.
+     * @param value - the value
+     */
+    private visit;
+    /**
+     * Whether nothing was collected.
+     * @returns true when no node or relationship was found
+     */
+    get empty(): boolean;
+}
+/**
+ * Fail with E_SOURCE_NOT_A_GRAPH when a result has rows but no node, relationship or path.
+ * @param result - the result
+ * @param collector - what it held
+ * @param report - the load's report
+ */
+export declare function requireGraph(result: QueryResult, collector: Collector, report: ImportReportBuilder): void;
+/**
+ * Write what was collected into the sink. A node already in the sink is updated, not counted again.
+ * @param c - the collector
+ * @param sink - the sink
+ * @param idProperty - the id property, or null
+ * @param report - the load's report
+ * @param signal - the load's signal
+ */
+export declare function writeCollected(c: Collector, sink: GraphSink, idProperty: string | null, report: ImportReportBuilder, signal: AbortSignal): void;
+/**
+ * Code-unit order of two strings, independent of locale.
+ * @param a - one string
+ * @param b - another
+ * @returns negative, zero or positive
+ */
+export declare function compareText(a: string, b: string): number;
+/**
+ * The canonical rows of what was collected: one line per node and relationship, sorted, for the
+ * content hash `validate` compares.
+ * @param c - the collector
+ * @param idProperty - the id property, or null
+ * @returns the lines
+ */
+export declare function canonicalRows(c: Collector, idProperty: string | null): string[];
+//# sourceMappingURL=flatten.d.ts.map

package/dist/src/sources/cypher/flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../../../src/sources/cypher/flatten.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAmB,KAAK,SAAS,EAA8B,MAAM,uBAAuB,CAAC;AAGpG,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGlE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAErD,sDAAsD;AACtD,MAAM,WAAW,WAAW;IACxB,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC;CAClD;AAqBD,mFAAmF;AACnF,qBAAa,SAAS;IAClB,QAAQ,CAAC,KAAK,yBAAgC;IAC9C,QAAQ,CAAC,IAAI,wBAA+B;IAC5C,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,sBAA6B;IAE7C;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAsB9C;;;OAGG;IACH,OAAO,CAAC,KAAK;IAgBb;;;OAGG;IACH,IAAI,KAAK,IAAI,OAAO,CAEnB;CACJ;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAMzG;AA4BD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC1B,CAAC,EAAE,SAAS,EACZ,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,WAAW,GACpB,IAAI,CAMN;AAwFD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAKxD;AA6BD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAqB/E"}

package/dist/src/sources/cypher/flatten.js

@@ -0,0 +1,279 @@
+/**
+ * The one result flattener of the Cypher source (design section 5): every node and relationship a
+ * result holds -- in a column, a path, a list or a map -- is collected once by its element id, and
+ * written to the sink as nodes (labels in the `labels` column, as the neo4j CSV importer has them)
+ * and directed edges (type in `type`, element id in `id`). A result of scalars only is
+ * E_SOURCE_NOT_A_GRAPH.
+ */
+import { INVALID_INDEX } from "@graphty/graph-format";
+import { throwIfAborted } from "../../common/input.js";
+import { failOn } from "../fail.js";
+import { SOURCE_DEGREE_ATTR } from "../ids.js";
+import { GraphNode, GraphRel } from "./types-map.js";
+/** The column names the neo4j CSV importer gives labels and types; spelled here so the Cypher chunk does not load it. */
+const LABELS_COLUMN = "labels";
+const TYPE_COLUMN = "type";
+/** The labels column, as the neo4j CSV importer declares it. */
+const LABELS_DECL = {
+    name: LABELS_COLUMN,
+    dtype: "list",
+    itemDtype: "dict",
+    nullable: true,
+    role: "labels",
+};
+/** The relationship type column. */
+const TYPE_DECL = { name: TYPE_COLUMN, dtype: "dict", nullable: true, role: "kind" };
+/** The edge id column. */
+const EDGE_ID_DECL = { name: "id", dtype: "string", nullable: true, role: "id" };
+/** The nodes, relationships and degree hints of one or more results, each once. */
+export class Collector {
+    constructor() {
+        this.nodes = new Map();
+        this.rels = new Map();
+        /** Degree hints by the id expression's value, as text. */
+        this.degrees = new Map();
+    }
+    /**
+     * Collect a result.
+     * @param result - the result
+     * @param hints - whether its `key` / `degree` / `degrees` columns are the generated queries' hints
+     */
+    add(result, hints) {
+        const key = hints ? result.fields.indexOf("key") : -1;
+        const degree = hints ? result.fields.indexOf("degree") : -1;
+        const degrees = hints ? result.fields.indexOf("degrees") : -1;
+        for (const row of result.rows) {
+            row.forEach((value, i) => {
+                if (i === degrees && Array.isArray(value)) {
+                    for (const pair of value) {
+                        if (Array.isArray(pair) && typeof pair[1] === "number") {
+                            this.degrees.set(String(pair[0]), pair[1]);
+                        }
+                    }
+                }
+                else if (i !== key && i !== degree) {
+                    this.visit(value);
+                }
+            });
+            if (key >= 0 && degree >= 0 && typeof row[degree] === "number") {
+                this.degrees.set(String(row[key]), row[degree]);
+            }
+        }
+    }
+    /**
+     * Collect every node and relationship inside a value.
+     * @param value - the value
+     */
+    visit(value) {
+        if (value instanceof GraphNode) {
+            this.nodes.set(value.id, value);
+        }
+        else if (value instanceof GraphRel) {
+            this.rels.set(value.id, value);
+        }
+        else if (Array.isArray(value)) {
+            value.forEach((v) => {
+                this.visit(v);
+            });
+        }
+        else if (value !== null && typeof value === "object") {
+            Object.values(value).forEach((v) => {
+                this.visit(v);
+            });
+        }
+    }
+    /**
+     * Whether nothing was collected.
+     * @returns true when no node or relationship was found
+     */
+    get empty() {
+        return this.nodes.size === 0 && this.rels.size === 0;
+    }
+}
+/**
+ * Fail with E_SOURCE_NOT_A_GRAPH when a result has rows but no node, relationship or path.
+ * @param result - the result
+ * @param collector - what it held
+ * @param report - the load's report
+ */
+export function requireGraph(result, collector, report) {
+    if (result.rows.length > 0 && collector.empty) {
+        failOn(report, "E_SOURCE_NOT_A_GRAPH", "the query returned no node, relationship or path", {
+            columns: result.fields,
+        });
+    }
+}
+/**
+ * The id a node gets: its `idProperty` value when it has one, else the server's element id.
+ * @param node - the node
+ * @param idProperty - the id property, or null
+ * @returns the id
+ */
+function nodeIdOf(node, idProperty) {
+    const value = idProperty === null ? undefined : node.properties[idProperty];
+    return typeof value === "string" || typeof value === "number" ? value : node.id;
+}
+/**
+ * A column handle, declared on first use.
+ * @param sink - the sink
+ * @param decl - the declaration
+ * @param domain - node or edge
+ * @returns the handle
+ */
+function column(sink, decl, domain) {
+    const existing = domain === "node" ? sink.nodeColumn(decl.name) : sink.edgeColumn(decl.name);
+    if (existing !== INVALID_INDEX) {
+        return existing;
+    }
+    return domain === "node" ? sink.declareNodeColumn(decl) : sink.declareEdgeColumn(decl);
+}
+/**
+ * Write what was collected into the sink. A node already in the sink is updated, not counted again.
+ * @param c - the collector
+ * @param sink - the sink
+ * @param idProperty - the id property, or null
+ * @param report - the load's report
+ * @param signal - the load's signal
+ */
+export function writeCollected(c, sink, idProperty, report, signal) {
+    if (sink.edgeCount === 0 && !sink.directedLocked && !sink.directed) {
+        sink.setDirected(true);
+    }
+    const ids = writeNodes(c, sink, idProperty, report, signal);
+    writeRels(c, sink, ids, report, signal, c.nodes.size);
+}
+/**
+ * Write the collected nodes into the sink.
+ * @param c - the collector
+ * @param sink - the sink
+ * @param idProperty - the id property, or null
+ * @param report - the load's report
+ * @param signal - the load's signal
+ * @returns each element id's node id
+ */
+function writeNodes(c, sink, idProperty, report, signal) {
+    const ids = new Map();
+    let n = 0;
+    for (const node of c.nodes.values()) {
+        if (n++ % 64 === 0) {
+            throwIfAborted(signal);
+        }
+        const id = nodeIdOf(node, idProperty);
+        ids.set(node.id, id);
+        const degree = c.degrees.get(String(idProperty === null ? node.id : id));
+        try {
+            const fresh = sink.indexOf(id) === INVALID_INDEX;
+            const index = sink.addNodeRecord(id, degree === undefined ? node.properties : { ...node.properties, [SOURCE_DEGREE_ATTR]: degree });
+            sink.setNodeValue(column(sink, LABELS_DECL, "node"), index, node.labels);
+            if (fresh) {
+                report.counts.nodes++;
+            }
+        }
+        catch (err) {
+            report.recordError(err, { element: String(id) });
+            report.counts.skippedNodes++;
+        }
+    }
+    return ids;
+}
+/**
+ * Write the collected relationships into the sink, adding any end the result did not return.
+ * @param c - the collector
+ * @param sink - the sink
+ * @param ids - each element id's node id
+ * @param report - the load's report
+ * @param signal - the load's signal
+ * @param written - how many elements were written before, for the abort check cadence
+ */
+function writeRels(c, sink, ids, report, signal, written) {
+    let n = written;
+    for (const rel of c.rels.values()) {
+        if (n++ % 64 === 0) {
+            throwIfAborted(signal);
+        }
+        // an end the result did not return is known only by its element id
+        const s = ids.get(rel.start) ?? rel.start;
+        const t = ids.get(rel.end) ?? rel.end;
+        try {
+            for (const end of [s, t]) {
+                if (sink.indexOf(end) === INVALID_INDEX) {
+                    sink.addNode(end);
+                    report.counts.nodes++;
+                }
+            }
+            const e = sink.addEdgeRecord(s, t, rel.properties, null);
+            sink.setEdgeValue(column(sink, TYPE_DECL, "edge"), e, rel.type);
+            sink.setEdgeValue(column(sink, EDGE_ID_DECL, "edge"), e, rel.id);
+            report.counts.edges++;
+        }
+        catch (err) {
+            report.recordError(err, { element: `${String(s)} -> ${String(t)}` });
+            report.counts.skippedEdges++;
+        }
+    }
+}
+/**
+ * Code-unit order of two strings, independent of locale.
+ * @param a - one string
+ * @param b - another
+ * @returns negative, zero or positive
+ */
+export function compareText(a, b) {
+    if (a === b) {
+        return 0;
+    }
+    return a < b ? -1 : 1;
+}
+/**
+ * One canonical object member.
+ * @param key - the key
+ * @param value - the value
+ * @returns `"key":value`
+ */
+function member(key, value) {
+    return `${JSON.stringify(key)}:${canonical(value)}`;
+}
+/**
+ * JSON with every object's keys sorted, so equal data spells the same.
+ * @param value - the value
+ * @returns the canonical text
+ */
+function canonical(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map(canonical).join(",")}]`;
+    }
+    if (value !== null && typeof value === "object") {
+        const entries = Object.entries(value).sort(([a], [b]) => compareText(a, b));
+        const members = entries.map(([k, v]) => member(k, v));
+        return `{${members.join(",")}}`;
+    }
+    return JSON.stringify(value) ?? "null";
+}
+/**
+ * The canonical rows of what was collected: one line per node and relationship, sorted, for the
+ * content hash `validate` compares.
+ * @param c - the collector
+ * @param idProperty - the id property, or null
+ * @returns the lines
+ */
+export function canonicalRows(c, idProperty) {
+    const ids = new Map();
+    const lines = [];
+    for (const node of c.nodes.values()) {
+        const id = nodeIdOf(node, idProperty);
+        ids.set(node.id, id);
+        lines.push(canonical(["n", id, [...node.labels].sort(compareText), node.properties]));
+    }
+    for (const rel of c.rels.values()) {
+        lines.push(canonical([
+            "r",
+            rel.id,
+            ids.get(rel.start) ?? rel.start,
+            ids.get(rel.end) ?? rel.end,
+            rel.type,
+            rel.properties,
+        ]));
+    }
+    return lines;
+}
+//# sourceMappingURL=flatten.js.map

package/dist/src/sources/cypher/flatten.js.map

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

package/dist/src/sources/cypher/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `@graphty/graph-io/sources/cypher`: the Cypher source and its `neo4j` and `neptune` presets
+ * (design sections 10, 11, 12.2 and 12.4). One query builder, one result flattener and one type
+ * mapper over four transports: Neo4j's Query API, Bolt (through the optional peer neo4j-driver),
+ * Neptune Database over HTTPS and Neptune Analytics. The presets fix the transports and the server
+ * profile and hold no query code of their own. Experimental.
+ * @module @graphty/graph-io/sources/cypher
+ */
+import { type GraphSource } from "../types.js";
+import { type CypherParams } from "./params.js";
+export { CYPHER_DESCRIPTOR, NEO4J_DESCRIPTOR, NEPTUNE_DESCRIPTOR } from "./descriptor.js";
+export { type CypherParams } from "./params.js";
+export { cypherIdentifier } from "./query-builder.js";
+/**
+ * The generic Cypher source, for any openCypher server: Neo4j over its Query API or Bolt, Neptune
+ * over HTTPS. The transport comes from `params.transport`, else the endpoint (`bolt+s://` is Bolt,
+ * a `neptune-graph` host is Neptune Analytics), else the Query API. Experimental.
+ * @category Network sources
+ */
+export declare const cypherSource: GraphSource<CypherParams>;
+/**
+ * The Neo4j preset: the Query API (Neo4j 5.26 and later, Aura), or Bolt for a `bolt:` or
+ * `bolt+s:` endpoint (any Neo4j; needs the optional peer neo4j-driver). Experimental.
+ * @category Network sources
+ */
+export declare const neo4jSource: GraphSource<CypherParams>;
+/**
+ * The Amazon Neptune preset: Neptune Database over HTTPS, or Neptune Analytics for a
+ * `neptune-graph` host. Node only; sign requests with `credentials.awsSigV4`. Experimental.
+ * @category Network sources
+ */
+export declare const neptuneSource: GraphSource<CypherParams>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/sources/cypher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/sources/cypher/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,OAAO,EAEH,KAAK,WAAW,EAQnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAsBhD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AA2hBtD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,YAAY,CAIjD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,YAAY,CAIhD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,YAAY,CAIlD,CAAC"}