@graphty/graph-io 0.3.47 → 0.3.49

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

@@ -0,0 +1,61 @@
+/**
+ * What differs between openCypher servers (design section 12.2, "the profile"): the id
+ * expression, and the server facts `probe` reports. Everything else in the Cypher source is shared.
+ */
+/**
+ * The Neo4j profile for a version: `elementId()` from 5.0, `id()` before.
+ * @param version - the server's version, or null when not known (assumed 5 or later)
+ * @param product - the product name
+ * @returns the profile
+ */
+export function neo4jProfile(version, product = "Neo4j") {
+    const major = version === null ? Number.NaN : Number.parseInt(version, 10);
+    return {
+        name: "neo4j",
+        elementIds: Number.isNaN(major) || major >= 5,
+        product,
+        version,
+        readOnly: "enforced",
+    };
+}
+/**
+ * The profile of a Bolt server from its agent string ("Neo4j/3.5.12"). A server that is not Neo4j
+ * gets `id()`, which every openCypher server has.
+ * @param agent - the server agent
+ * @returns the profile
+ */
+export function profileFromAgent(agent) {
+    const [product = "", version = ""] = agent.split("/");
+    if (product.toLowerCase() === "neo4j") {
+        return neo4jProfile(version === "" ? null : version);
+    }
+    return {
+        name: "neo4j",
+        elementIds: false,
+        product,
+        version: version === "" ? null : version,
+        readOnly: "enforced",
+    };
+}
+/**
+ * The Neptune profile: ids are `id(n)`, the `~id` string, never reused.
+ * @param version - the engine version, when known
+ * @returns the profile
+ */
+export function neptuneProfile(version = null) {
+    return { name: "neptune", elementIds: false, product: "Neptune", version, readOnly: "not-enforced" };
+}
+/**
+ * The server facts of a profile, as `probe` and `report.source.server` give them.
+ * @param profile - the profile
+ * @returns the facts
+ */
+export function serverFacts(profile) {
+    return {
+        product: profile.product,
+        profile: profile.name,
+        readOnly: profile.readOnly,
+        ...(profile.version === null ? {} : { version: profile.version }),
+    };
+}
+//# sourceMappingURL=profiles.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../../../src/sources/cypher/profiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAsB,EAAE,OAAO,GAAG,OAAO;IAClE,MAAM,KAAK,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC3E,OAAO;QACH,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAC7C,OAAO;QACP,OAAO;QACP,QAAQ,EAAE,UAAU;KACvB,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC1C,MAAM,CAAC,OAAO,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAC;QACpC,OAAO,YAAY,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IACD,OAAO;QACH,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,KAAK;QACjB,OAAO;QACP,OAAO,EAAE,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;QACxC,QAAQ,EAAE,UAAU;KACvB,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,UAAyB,IAAI;IACxD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;AACzG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAAsB;IAC9C,OAAO;QACH,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;KACpE,CAAC;AACN,CAAC"}

package/dist/src/sources/cypher/query-builder.d.ts

@@ -0,0 +1,123 @@
+/**
+ * The one query builder of the Cypher source (design sections 11 and 12.2). Caller values travel
+ * as query parameters, never spliced. What Cypher cannot parameterize -- labels, relationship
+ * types, property keys, variable-length bounds and LIMIT -- is either backtick-quoted (an
+ * identifier, a backtick inside doubled) or inlined as a checked integer. The generated queries
+ * differ between servers only in the id expression.
+ */
+import { type ImportReportBuilder } from "../../common/report.js";
+import { type CypherProfile } from "./profiles.js";
+/** The deepest neighborhood a generated query asks for. */
+export declare const MAX_DEPTH = 10;
+/** The largest page of mode "all". */
+export declare const MAX_PAGE_SIZE = 100000;
+/** The page size of mode "all" when the caller gives none. */
+export declare const DEFAULT_PAGE_SIZE = 1000;
+/**
+ * Quote one Cypher identifier (a label, relationship type or property key) for a query: wrapped in
+ * backticks, with every backtick inside doubled, so no value can end the identifier early. An
+ * empty name, or one with a NUL character, is refused (E_SOURCE_PARAM, reason "identifier").
+ * Experimental.
+ * @param name - the identifier
+ * @returns the quoted identifier
+ * @example
+ * ```ts
+ * cypherIdentifier("Person"); // "`Person`"
+ * cypherIdentifier("odd`name"); // "`odd``name`"
+ * ```
+ * @category Network sources
+ */
+export declare function cypherIdentifier(name: string): string;
+/**
+ * Quote an identifier a parameter gave, failing the load when it cannot be.
+ * @param name - the identifier
+ * @param param - the parameter it came from
+ * @param report - the load's report
+ * @returns the quoted identifier
+ */
+export declare function quoted(name: unknown, param: string, report: ImportReportBuilder): string;
+/**
+ * An integer to inline, checked to lie in its range.
+ * @param value - the value
+ * @param name - the parameter it came from
+ * @param min - the smallest allowed
+ * @param max - the largest allowed
+ * @param report - the load's report
+ * @returns the integer, as query text
+ */
+export declare function checkedInteger(value: unknown, name: string, min: number, max: number, report: ImportReportBuilder): string;
+/** What narrows a generated query: compiled into it, so filtering happens at the source. */
+export interface QueryFilters {
+    /** Quoted labels; a node must have one of them. */
+    readonly labels: readonly string[];
+    /** Quoted relationship types. */
+    readonly relationshipTypes: readonly string[];
+    /** The quoted id property, or null for the server's id. */
+    readonly idProperty: string | null;
+}
+/**
+ * One page of the nodes of mode "all", ordered by the id expression (keyset paging, never SKIP).
+ * @param profile - the server's profile
+ * @param filters - the filters
+ * @param pageSize - the checked page size, as text
+ * @param after - whether the page starts after `$after`
+ * @param degree - whether to add the degree hint
+ * @returns the statement; it reads `$after`
+ */
+export declare function nodePage(profile: CypherProfile, filters: QueryFilters, pageSize: string, after: boolean, degree: boolean): string;
+/**
+ * One page of the relationships of mode "all", with their end nodes, ordered by the relationship
+ * id expression.
+ * @param profile - the server's profile
+ * @param filters - the filters
+ * @param pageSize - the checked page size, as text
+ * @param after - whether the page starts after `$after`
+ * @returns the statement; it reads `$after`
+ */
+export declare function edgePage(profile: CypherProfile, filters: QueryFilters, pageSize: string, after: boolean): string;
+/**
+ * The relationships among the nodes a capped mode "all" has loaded: both ends at or before the
+ * node page's last key `$last`, and, after the first page, one end past the previous page's last
+ * key `$after`, so each relationship arrives with the page that loads its later end.
+ * @param profile - the server's profile
+ * @param filters - the filters
+ * @param after - whether earlier pages were loaded
+ * @returns the statement; it reads `$last` and `$after`
+ */
+export declare function edgesAmong(profile: CypherProfile, filters: QueryFilters, after: boolean): string;
+/** How far a neighborhood reaches. */
+interface NeighborhoodShape {
+    /** The checked depth, as text. */
+    readonly depth: string;
+    /** Which way relationships are followed. */
+    readonly direction: "out" | "in" | "both";
+    /** The checked path limit, as text, or null for none. */
+    readonly limit: string | null;
+    /** Whether the page starts after the neighbor key `$after` (a capped expansion's next page). */
+    readonly after?: boolean;
+}
+/**
+ * The neighborhood of the seeds `$ids`: every path up to `depth` hops, each seed included even with
+ * no neighbor, plus the degree of every node returned.
+ * @param profile - the server's profile
+ * @param filters - the filters
+ * @param shape - depth, direction and limit
+ * @param degree - whether to add the degree hint
+ * @returns the statement; it reads `$ids`
+ */
+export declare function neighborhood(profile: CypherProfile, filters: QueryFilters, shape: NeighborhoodShape, degree: boolean): string;
+/**
+ * The counts of mode "all", for a progress total.
+ * @param filters - the filters
+ * @returns two statements: the nodes, then the relationships
+ */
+export declare function counts(filters: QueryFilters): readonly [string, string];
+/**
+ * The node count of a mode "all" load with at most one label and the server's ids: a pattern
+ * Neo4j answers from its count store in one cheap lookup, whatever the graph's size.
+ * @param label - the quoted label, or undefined for every node
+ * @returns the statement
+ */
+export declare function storeCount(label: string | undefined): string;
+export {};
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/src/sources/cypher/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../../../src/sources/cypher/query-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,2DAA2D;AAC3D,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,sCAAsC;AACtC,eAAO,MAAM,aAAa,SAAU,CAAC;AAErC,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAWtC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAQxF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,mBAAmB,GAC5B,MAAM,CAWR;AAED,4FAA4F;AAC5F,MAAM,WAAW,YAAY;IACzB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,iCAAiC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAwDD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACpB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,OAAO,GAChB,MAAM,CAYR;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAchH;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAWhG;AAED,sCAAsC;AACtC,UAAU,iBAAiB;IACvB,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gGAAgG;IAChG,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CACxB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,OAAO,GAChB,MAAM,CA2BR;AAWD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAOvE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG5D"}

package/dist/src/sources/cypher/query-builder.js

@@ -0,0 +1,267 @@
+/**
+ * The one query builder of the Cypher source (design sections 11 and 12.2). Caller values travel
+ * as query parameters, never spliced. What Cypher cannot parameterize -- labels, relationship
+ * types, property keys, variable-length bounds and LIMIT -- is either backtick-quoted (an
+ * identifier, a backtick inside doubled) or inlined as a checked integer. The generated queries
+ * differ between servers only in the id expression.
+ */
+import { failAlone, failOn } from "../fail.js";
+/** The deepest neighborhood a generated query asks for. */
+export const MAX_DEPTH = 10;
+/** The largest page of mode "all". */
+export const MAX_PAGE_SIZE = 100000;
+/** The page size of mode "all" when the caller gives none. */
+export const DEFAULT_PAGE_SIZE = 1000;
+/**
+ * Why an identifier cannot be quoted, or null when it can.
+ * @param name - the identifier
+ * @returns the reason, or null
+ */
+function identifierProblem(name) {
+    return typeof name !== "string" || name === "" || name.includes("\u0000") ? "identifier" : null;
+}
+/**
+ * Quote one Cypher identifier (a label, relationship type or property key) for a query: wrapped in
+ * backticks, with every backtick inside doubled, so no value can end the identifier early. An
+ * empty name, or one with a NUL character, is refused (E_SOURCE_PARAM, reason "identifier").
+ * Experimental.
+ * @param name - the identifier
+ * @returns the quoted identifier
+ * @example
+ * ```ts
+ * cypherIdentifier("Person"); // "`Person`"
+ * cypherIdentifier("odd`name"); // "`odd``name`"
+ * ```
+ * @category Network sources
+ */
+export function cypherIdentifier(name) {
+    if (identifierProblem(name) !== null) {
+        failAlone("E_SOURCE_PARAM", "a Cypher identifier must be a non-empty string without NUL", {
+            name: "identifier",
+            reason: "identifier",
+        });
+    }
+    return `\`${name.replaceAll("`", "``")}\``;
+}
+/**
+ * Quote an identifier a parameter gave, failing the load when it cannot be.
+ * @param name - the identifier
+ * @param param - the parameter it came from
+ * @param report - the load's report
+ * @returns the quoted identifier
+ */
+export function quoted(name, param, report) {
+    if (identifierProblem(name) !== null) {
+        failOn(report, "E_SOURCE_PARAM", `parameter ${param}: not a Cypher identifier`, {
+            name: param,
+            reason: "identifier",
+        });
+    }
+    return cypherIdentifier(name);
+}
+/**
+ * An integer to inline, checked to lie in its range.
+ * @param value - the value
+ * @param name - the parameter it came from
+ * @param min - the smallest allowed
+ * @param max - the largest allowed
+ * @param report - the load's report
+ * @returns the integer, as query text
+ */
+export function checkedInteger(value, name, min, max, report) {
+    if (typeof value !== "number" || !Number.isInteger(value)) {
+        failOn(report, "E_SOURCE_PARAM", `parameter ${name}: not an integer`, { name, reason: "type" });
+    }
+    if (value < min || value > max) {
+        failOn(report, "E_SOURCE_PARAM", `parameter ${name}: outside ${String(min)} to ${String(max)}`, {
+            name,
+            reason: "range",
+        });
+    }
+    return String(value);
+}
+/**
+ * The id expression of a node or relationship variable.
+ * @param v - the variable
+ * @param profile - the server's profile
+ * @param filters - the id property, for a node
+ * @param node - whether `v` is a node
+ * @returns the expression
+ */
+function idExpression(v, profile, filters, node = true) {
+    if (node && filters.idProperty !== null) {
+        return `${v}.${filters.idProperty}`;
+    }
+    return profile.elementIds ? `elementId(${v})` : `id(${v})`;
+}
+/**
+ * The node predicate of the label and id property filters, or null.
+ * @param v - the node variable
+ * @param filters - the filters
+ * @returns the predicate
+ */
+function nodePredicate(v, filters) {
+    const parts = [];
+    if (filters.labels.length > 0) {
+        const prefix = `${v}:`;
+        parts.push(`(${filters.labels.map((l) => prefix + l).join(" OR ")})`);
+    }
+    if (filters.idProperty !== null) {
+        parts.push(`${v}.${filters.idProperty} IS NOT NULL`);
+    }
+    return parts.length === 0 ? null : parts.join(" AND ");
+}
+/**
+ * The relationship type part of a pattern: `:`A`|`B``, or "".
+ * @param filters - the filters
+ * @returns the pattern text
+ */
+function typesPattern(filters) {
+    return filters.relationshipTypes.length === 0 ? "" : `:${filters.relationshipTypes.join("|")}`;
+}
+/**
+ * The degree hint of a node variable: its relationship count, by pattern comprehension.
+ * @param v - the variable
+ * @returns the expression
+ */
+function degreeOf(v) {
+    return `size([(${v})--() | 1])`;
+}
+/** The arrows of each direction around a relationship pattern. */
+const ARROWS = { out: ["-", "->"], in: ["<-", "-"], both: ["-", "-"] };
+/**
+ * One page of the nodes of mode "all", ordered by the id expression (keyset paging, never SKIP).
+ * @param profile - the server's profile
+ * @param filters - the filters
+ * @param pageSize - the checked page size, as text
+ * @param after - whether the page starts after `$after`
+ * @param degree - whether to add the degree hint
+ * @returns the statement; it reads `$after`
+ */
+export function nodePage(profile, filters, pageSize, after, degree) {
+    const where = nodePredicate("n", filters);
+    return [
+        "MATCH (n)",
+        where === null ? null : `WHERE ${where}`,
+        `WITH n, ${idExpression("n", profile, filters)} AS key`,
+        after ? "WHERE key > $after" : null,
+        degree ? `RETURN n, key, ${degreeOf("n")} AS degree` : "RETURN n, key",
+        `ORDER BY key LIMIT ${pageSize}`,
+    ]
+        .filter((l) => l !== null)
+        .join(" ");
+}
+/**
+ * One page of the relationships of mode "all", with their end nodes, ordered by the relationship
+ * id expression.
+ * @param profile - the server's profile
+ * @param filters - the filters
+ * @param pageSize - the checked page size, as text
+ * @param after - whether the page starts after `$after`
+ * @returns the statement; it reads `$after`
+ */
+export function edgePage(profile, filters, pageSize, after) {
+    const a = nodePredicate("a", filters);
+    const b = nodePredicate("b", filters);
+    const where = [a, b].filter((p) => p !== null);
+    return [
+        `MATCH (a)-[r${typesPattern(filters)}]->(b)`,
+        where.length === 0 ? null : `WHERE ${where.join(" AND ")}`,
+        `WITH a, r, b, ${idExpression("r", profile, filters, false)} AS key`,
+        after ? "WHERE key > $after" : null,
+        "RETURN a, r, b, key",
+        `ORDER BY key LIMIT ${pageSize}`,
+    ]
+        .filter((l) => l !== null)
+        .join(" ");
+}
+/**
+ * The relationships among the nodes a capped mode "all" has loaded: both ends at or before the
+ * node page's last key `$last`, and, after the first page, one end past the previous page's last
+ * key `$after`, so each relationship arrives with the page that loads its later end.
+ * @param profile - the server's profile
+ * @param filters - the filters
+ * @param after - whether earlier pages were loaded
+ * @returns the statement; it reads `$last` and `$after`
+ */
+export function edgesAmong(profile, filters, after) {
+    const where = [nodePredicate("a", filters), nodePredicate("b", filters)].filter((p) => p !== null);
+    return [
+        `MATCH (a)-[r${typesPattern(filters)}]->(b)`,
+        where.length === 0 ? null : `WHERE ${where.join(" AND ")}`,
+        `WITH a, r, b, ${idExpression("a", profile, filters)} AS ka, ${idExpression("b", profile, filters)} AS kb`,
+        `WHERE ka <= $last AND kb <= $last${after ? " AND (ka > $after OR kb > $after)" : ""}`,
+        "RETURN a, r, b",
+    ]
+        .filter((l) => l !== null)
+        .join(" ");
+}
+/**
+ * The neighborhood of the seeds `$ids`: every path up to `depth` hops, each seed included even with
+ * no neighbor, plus the degree of every node returned.
+ * @param profile - the server's profile
+ * @param filters - the filters
+ * @param shape - depth, direction and limit
+ * @param degree - whether to add the degree hint
+ * @returns the statement; it reads `$ids`
+ */
+export function neighborhood(profile, filters, shape, degree) {
+    const rel = `[${typesPattern(filters)}*1..${shape.depth}]`;
+    const [left, right] = ARROWS[shape.direction];
+    const pattern = `${left}${rel}${right}`;
+    const x = nodePredicate("x", filters);
+    const degrees = degree
+        ? `, [m IN CASE WHEN p IS NULL THEN [s] ELSE nodes(p) END | [${idExpression("m", profile, filters)}, ${degreeOf("m")}]] AS degrees`
+        : "";
+    // A capped expansion is ordered by the neighbor's key, so its next page starts after the last
+    // key it returned. ponytail: a page boundary falling between two paths to the same neighbor
+    // (parallel relationships, or depth > 1) drops the later paths; page on (key, path) if that matters.
+    const head = [
+        `MATCH (s) WHERE ${idExpression("s", profile, filters)} IN $ids`,
+        `OPTIONAL MATCH p = (s)${pattern}(x)${whereClause(x)}`,
+    ];
+    if (shape.limit === null) {
+        return [...head, "WITH s, p", `RETURN s, p${degrees}`].join(" ");
+    }
+    return [
+        ...head,
+        `WITH s, p, ${idExpression("x", profile, filters)} AS key`,
+        shape.after === true ? "WHERE key > $after" : null,
+        `WITH s, p, key ORDER BY key LIMIT ${shape.limit}`,
+        `RETURN s, p, key${degrees}`,
+    ]
+        .filter((l) => l !== null)
+        .join(" ");
+}
+/**
+ * A ` WHERE` clause for a predicate.
+ * @param predicate - the predicate, or null
+ * @returns the clause with its leading space, or "" for no predicate
+ */
+function whereClause(predicate) {
+    return predicate === null ? "" : ` WHERE ${predicate}`;
+}
+/**
+ * The counts of mode "all", for a progress total.
+ * @param filters - the filters
+ * @returns two statements: the nodes, then the relationships
+ */
+export function counts(filters) {
+    const n = nodePredicate("n", filters);
+    const where = [nodePredicate("a", filters), nodePredicate("b", filters)].filter((p) => p !== null);
+    return [
+        `MATCH (n)${whereClause(n)} RETURN count(n) AS c`,
+        `MATCH (a)-[r${typesPattern(filters)}]->(b)${whereClause(where.length === 0 ? null : where.join(" AND "))} RETURN count(r) AS c`,
+    ];
+}
+/**
+ * The node count of a mode "all" load with at most one label and the server's ids: a pattern
+ * Neo4j answers from its count store in one cheap lookup, whatever the graph's size.
+ * @param label - the quoted label, or undefined for every node
+ * @returns the statement
+ */
+export function storeCount(label) {
+    const pattern = label === undefined ? "n" : `n:${label}`;
+    return `MATCH (${pattern}) RETURN count(n) AS c`;
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/src/sources/cypher/query-builder.js.map

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

package/dist/src/sources/cypher/transports/bolt.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The `bolt` transport (design sections 9 and 12.2): the official neo4j-driver, an optional peer
+ * dependency imported only here. Absent, a load fails with E_SOURCE_RUNTIME (`reason:
+ * "needs-peer-dependency"`). It is the only path to a Neo4j older than 5.26, such as Hetionet's 3.5.
+ *
+ * - Direct connections only (`bolt:`, `bolt+s:`, `bolt+ssc:`): a routing scheme would send the
+ *   credential to every host the routing table lists, so `neo4j:` schemes are refused.
+ * - `+ssc` accepts any certificate, so it is refused with a credential; plain `bolt:` is refused
+ *   with one unless the host is this machine or `allowInsecure` is set.
+ * - Statements run as auto-commit `session.run` in a READ session, never as managed transactions,
+ *   which retry a server timeout for 30 s.
+ * - Integers stay lossless and are converted by the type mapper; the signal closes the session.
+ */
+import { type Transport, type TransportInput } from "./transport.js";
+/**
+ * Make the transport: import the driver, check the endpoint and credential, open a READ session.
+ * @param input - the context, params and mapper
+ * @returns the transport
+ */
+export declare function boltTransport(input: TransportInput): Promise<Transport>;
+//# sourceMappingURL=bolt.d.ts.map

package/dist/src/sources/cypher/transports/bolt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bolt.d.ts","sourceRoot":"","sources":["../../../../../src/sources/cypher/transports/bolt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAqHlF;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAoF7E"}