@graphty/graph-io 0.3.47 → 0.3.48

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

@@ -0,0 +1,106 @@
+/**
+ * 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;
+/** 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];
+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,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"}

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

@@ -0,0 +1,236 @@
+/**
+ * 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 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`,
+    ];
+}
+//# 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"}

package/dist/src/sources/cypher/transports/bolt.js

@@ -0,0 +1,185 @@
+/**
+ * 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 { throwIfAborted } from "../../../common/input.js";
+import { isLoopback, transportOptions } from "../../context.js";
+import { originOf, unwrapCredential } from "../../credentials.js";
+import { failOn } from "../../fail.js";
+import { profileFromAgent } from "../profiles.js";
+import { fromDriver } from "../types-map.js";
+import { serverError } from "./transport.js";
+/** The optional peer dependency. */
+const DRIVER_PACKAGE = "neo4j-driver";
+/** The URL schemes of a direct Bolt connection. */
+const DIRECT_SCHEMES = new Set(["bolt:", "bolt+s:", "bolt+ssc:"]);
+/**
+ * Import the optional peer dependency.
+ * @param input - the transport input
+ * @returns the driver module
+ */
+async function loadDriver(input) {
+    let mod;
+    try {
+        mod = (await import("neo4j-driver"));
+    }
+    catch {
+        return failOn(input.ctx.report, "E_SOURCE_RUNTIME", `the bolt transport needs ${DRIVER_PACKAGE} installed`, {
+            runtime: input.ctx.runtime,
+            reason: "needs-peer-dependency",
+            package: DRIVER_PACKAGE,
+        });
+    }
+    return mod.default ?? mod;
+}
+/**
+ * Fail when an https page would open a plain Bolt WebSocket to another machine, which the browser
+ * blocks.
+ * @param ctx - the context
+ * @param url - the endpoint
+ */
+function refuseMixedContent(ctx, url) {
+    const page = globalThis.location;
+    if (ctx.runtime === "browser" &&
+        page?.protocol === "https:" &&
+        url.protocol === "bolt:" &&
+        !isLoopback(url.hostname)) {
+        failOn(ctx.report, "E_SOURCE_RUNTIME", "an https page cannot open a plain Bolt WebSocket", {
+            runtime: ctx.runtime,
+            reason: "insecure-endpoint",
+        });
+    }
+}
+/**
+ * Check the endpoint and the credential before connecting, and turn the credential into the
+ * driver's auth token.
+ * @param input - the transport input
+ * @param neo4j - the driver module
+ * @returns the URL and auth token
+ */
+async function connection(input, neo4j) {
+    const { ctx } = input;
+    const { report } = ctx;
+    const bad = (reason, message) => failOn(report, "E_SOURCE_PARAM", message, { name: "endpoint", reason });
+    const url = ctx.endpoint ?? bad("missing", "the bolt transport needs an endpoint");
+    if (!DIRECT_SCHEMES.has(url.protocol)) {
+        bad(url.protocol.startsWith("neo4j") ? "routing" : "scheme", `${url.protocol} is not a direct Bolt scheme`);
+    }
+    refuseMixedContent(ctx, url);
+    const { credential, allowInsecure } = transportOptions(ctx);
+    const origin = originOf(url);
+    const bound = credential !== undefined && (credential.origins.length === 0 || credential.origins.includes(origin));
+    if (!bound || credential === undefined) {
+        return { url, auth: undefined };
+    }
+    if (url.protocol === "bolt+ssc:") {
+        bad("unverified-tls", "bolt+ssc accepts any certificate, so no credential is sent over it");
+    }
+    if (url.protocol === "bolt:" && !isLoopback(url.hostname) && allowInsecure !== true) {
+        bad("insecure-endpoint", "a credential is never sent without TLS");
+    }
+    const secret = unwrapCredential(credential);
+    if (secret !== undefined && "username" in secret) {
+        return { url, auth: neo4j.auth.basic(secret.username, secret.password) };
+    }
+    if (secret !== undefined && "token" in secret) {
+        const token = typeof secret.token === "string" ? secret.token : await secret.token();
+        return { url, auth: neo4j.auth.bearer(token) };
+    }
+    return failOn(report, "E_SOURCE_PARAM", "the bolt transport takes a basic or bearer credential", {
+        name: "credential",
+        reason: "kind",
+    });
+}
+/**
+ * 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 async function boltTransport(input) {
+    const { ctx, params, m } = input;
+    throwIfAborted(ctx.signal);
+    const neo4j = await loadDriver(input);
+    const { url, auth } = await connection(input, neo4j);
+    throwIfAborted(ctx.signal);
+    const origin = originOf(url);
+    const { userAgent } = transportOptions(ctx);
+    const driver = neo4j.driver(`${url.protocol}//${url.host}`, auth, userAgent === undefined ? {} : { userAgent });
+    const session = driver.session({
+        defaultAccessMode: neo4j.session.READ,
+        ...(params.database === undefined ? {} : { database: params.database }),
+    });
+    let closed = null;
+    const close = () => {
+        closed ?? (closed = session
+            .close()
+            .catch(() => undefined)
+            .then(() => driver.close())
+            .catch(() => undefined));
+        return closed;
+    };
+    const onAbort = () => {
+        void close();
+    };
+    ctx.signal.addEventListener("abort", onAbort, { once: true });
+    const fail = (err) => {
+        throwIfAborted(ctx.signal);
+        const e = err;
+        const code = typeof e.code === "string" ? e.code : null;
+        if (code === null || code === "ServiceUnavailable" || code === "SessionExpired") {
+            return ctx.runtime === "browser"
+                ? failOn(ctx.report, "E_SOURCE_BLOCKED", `${origin} could not be reached over Bolt`, {
+                    url: origin,
+                    cause: "unknown",
+                })
+                : failOn(ctx.report, "E_FETCH", `${origin} could not be reached over Bolt`, {
+                    url: origin,
+                    status: null,
+                });
+        }
+        return serverError(ctx.report, {
+            code,
+            message: typeof e.message === "string" ? e.message : "",
+            status: null,
+            showable: code.startsWith("Neo.ClientError."),
+        }, origin, params.database);
+    };
+    let detected = null;
+    const profile = async () => {
+        if (detected === null) {
+            const info = await driver.getServerInfo().catch(fail);
+            detected = profileFromAgent(info.agent ?? "");
+        }
+        return detected;
+    };
+    const timeout = ctx.limits.timeoutMs;
+    return {
+        async run(statement, parameters) {
+            throwIfAborted(ctx.signal);
+            const result = await session
+                .run(statement, parameters, timeout === undefined ? undefined : { timeout })
+                .catch(fail);
+            const fields = (result.records[0]?.keys ?? []).map(String);
+            return {
+                fields,
+                rows: result.records.map((r) => fields.map((k) => fromDriver(r.get(k), k, m, neo4j))),
+            };
+        },
+        profile,
+        probe: profile,
+        close: async () => {
+            ctx.signal.removeEventListener("abort", onAbort);
+            await close();
+        },
+    };
+}
+//# sourceMappingURL=bolt.js.map

package/dist/src/sources/cypher/transports/bolt.js.map

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

package/dist/src/sources/cypher/transports/neptune-analytics.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The `neptune-analytics` transport (design section 12.4): `POST /queries` on the graph's host
+ * (`<graph-id>.<region>.neptune-graph.amazonaws.com`), JSON `{ query, language: "OPEN_CYPHER",
+ * parameters }`, always signed with `credentials.awsSigV4` for the service "neptune-graph".
+ * Results share Neptune Database's `~id` shape. Node only until CORS on a graph host is shown to
+ * work: a browser is refused before any request (E_SOURCE_RUNTIME, reason "cors").
+ */
+import { type Transport, type TransportInput } from "./transport.js";
+/**
+ * Make the transport.
+ * @param input - the context, params and mapper
+ * @returns the transport
+ */
+export declare function neptuneAnalyticsTransport(input: TransportInput): Transport;
+//# sourceMappingURL=neptune-analytics.d.ts.map

package/dist/src/sources/cypher/transports/neptune-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neptune-analytics.d.ts","sourceRoot":"","sources":["../../../../../src/sources/cypher/transports/neptune-analytics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAsB1E"}

package/dist/src/sources/cypher/transports/neptune-analytics.js

@@ -0,0 +1,38 @@
+/**
+ * The `neptune-analytics` transport (design section 12.4): `POST /queries` on the graph's host
+ * (`<graph-id>.<region>.neptune-graph.amazonaws.com`), JSON `{ query, language: "OPEN_CYPHER",
+ * parameters }`, always signed with `credentials.awsSigV4` for the service "neptune-graph".
+ * Results share Neptune Database's `~id` shape. Node only until CORS on a graph host is shown to
+ * work: a browser is refused before any request (E_SOURCE_RUNTIME, reason "cors").
+ */
+import { neptuneProfile } from "../profiles.js";
+import { neptuneResult, nodeOnly } from "./neptune-https.js";
+/**
+ * Make the transport.
+ * @param input - the context, params and mapper
+ * @returns the transport
+ */
+export function neptuneAnalyticsTransport(input) {
+    const { ctx } = input;
+    nodeOnly(ctx, "neptune-analytics");
+    const run = async (statement, parameters) => {
+        const response = await ctx.fetch("queries", {
+            method: "POST",
+            idempotent: true,
+            allowStatus: [400, 500],
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ query: statement, language: "OPEN_CYPHER", parameters }),
+        });
+        return neptuneResult(input, response);
+    };
+    return {
+        run,
+        profile: () => Promise.resolve(neptuneProfile()),
+        probe: async () => {
+            await run("RETURN 1 AS ok", {});
+            return neptuneProfile();
+        },
+        close: () => Promise.resolve(),
+    };
+}
+//# sourceMappingURL=neptune-analytics.js.map

package/dist/src/sources/cypher/transports/neptune-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neptune-analytics.js","sourceRoot":"","sources":["../../../../../src/sources/cypher/transports/neptune-analytics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG7D;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAqB;IAC3D,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,KAAK,EAAE,SAAiB,EAAE,UAA6C,EAAwB,EAAE;QACzG,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE;YACxC,MAAM,EAAE,MAAM;YACd,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;YACvB,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;SAClF,CAAC,CAAC;QACH,OAAO,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC,CAAC;IACF,OAAO;QACH,GAAG;QACH,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAChD,KAAK,EAAE,KAAK,IAAI,EAAE;YACd,MAAM,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;YAChC,OAAO,cAAc,EAAE,CAAC;QAC5B,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;KACjC,CAAC;AACN,CAAC"}