@graphty/graph-io 0.3.47 → 0.3.49

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"}

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

@@ -0,0 +1,31 @@
+/**
+ * The `neptune-https` transport (design section 12.4): Neptune Database's `POST /openCypher`
+ * (port 8182, TLS only), form fields `query` and `parameters`, signed with `credentials.awsSigV4`
+ * (service "neptune-db") or unsigned inside the VPC. Node only: Neptune Database sends no CORS
+ * headers, so a browser is refused before any request (E_SOURCE_RUNTIME, reason "cors").
+ *
+ * An error after the first chunk of a 200 answer is appended to the body; the tail is read for it.
+ */
+import { type SourceContext } from "../../types.js";
+import { type QueryResult } from "../flatten.js";
+import { type Transport, type TransportInput } from "./transport.js";
+/**
+ * Refuse a Neptune transport where it cannot run.
+ * @param ctx - the context
+ * @param transport - the transport name
+ */
+export declare function nodeOnly(ctx: SourceContext, transport: string): void;
+/**
+ * Turn a Neptune answer into a result, or raise its error.
+ * @param input - the transport input
+ * @param response - the answer
+ * @returns the mapped result
+ */
+export declare function neptuneResult(input: TransportInput, response: Response): Promise<QueryResult>;
+/**
+ * Make the transport.
+ * @param input - the context, params and mapper
+ * @returns the transport
+ */
+export declare function neptuneHttpsTransport(input: TransportInput): Transport;
+//# sourceMappingURL=neptune-https.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"neptune-https.d.ts","sourceRoot":"","sources":["../../../../../src/sources/cypher/transports/neptune-https.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,OAAO,EAAsC,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AASzG;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAOpE;AAiBD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAmCnG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAoBtE"}

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

@@ -0,0 +1,104 @@
+/**
+ * The `neptune-https` transport (design section 12.4): Neptune Database's `POST /openCypher`
+ * (port 8182, TLS only), form fields `query` and `parameters`, signed with `credentials.awsSigV4`
+ * (service "neptune-db") or unsigned inside the VPC. Node only: Neptune Database sends no CORS
+ * headers, so a browser is refused before any request (E_SOURCE_RUNTIME, reason "cors").
+ *
+ * An error after the first chunk of a 200 answer is appended to the body; the tail is read for it.
+ */
+import { originOf } from "../../credentials.js";
+import { failOn } from "../../fail.js";
+import { neptuneProfile } from "../profiles.js";
+import { fromNeptune } from "../types-map.js";
+import { objectRows, parseJson, serverError } from "./transport.js";
+/**
+ * Refuse a Neptune transport where it cannot run.
+ * @param ctx - the context
+ * @param transport - the transport name
+ */
+export function nodeOnly(ctx, transport) {
+    if (ctx.runtime === "browser" || ctx.runtime === "worker") {
+        failOn(ctx.report, "E_SOURCE_RUNTIME", `the ${transport} transport cannot run in a browser`, {
+            runtime: ctx.runtime,
+            reason: "cors",
+        });
+    }
+}
+/**
+ * The error a body ends with, when a 200 answer was cut short by one.
+ * @param text - the body
+ * @returns the error, or null
+ */
+function trailingError(text) {
+    for (let at = text.lastIndexOf("{"); at > 0; at = text.lastIndexOf("{", at - 1)) {
+        const tail = parseJson(text.slice(at));
+        if (tail !== null && typeof tail.code === "string") {
+            return tail;
+        }
+    }
+    return null;
+}
+/**
+ * Turn a Neptune answer into a result, or raise its error.
+ * @param input - the transport input
+ * @param response - the answer
+ * @returns the mapped result
+ */
+export async function neptuneResult(input, response) {
+    const { ctx, m } = input;
+    const origin = ctx.endpoint === null ? "" : originOf(ctx.endpoint);
+    const text = await response.text();
+    const body = parseJson(text);
+    let error = typeof body?.code === "string" ? body : null;
+    if (body === null) {
+        error = trailingError(text);
+    }
+    if (error !== null) {
+        serverError(ctx.report, {
+            code: error.code ?? null,
+            message: error.detailedMessage ?? error.message ?? "",
+            status: response.status,
+            showable: body !== null && response.status >= 400 && response.status < 500,
+        }, origin, undefined);
+    }
+    if (!response.ok) {
+        failOn(ctx.report, "E_FETCH", `${origin} answered ${String(response.status)}`, {
+            url: origin,
+            status: response.status,
+        });
+    }
+    if (body === null || !Array.isArray(body.results)) {
+        failOn(ctx.report, "E_SOURCE_RESPONSE", "the Neptune answer has no results", {
+            expected: "json",
+            contentType: response.headers.get("content-type"),
+        });
+    }
+    return objectRows(body.results, (v, column) => fromNeptune(v, column, m));
+}
+/**
+ * Make the transport.
+ * @param input - the context, params and mapper
+ * @returns the transport
+ */
+export function neptuneHttpsTransport(input) {
+    const { ctx } = input;
+    nodeOnly(ctx, "neptune-https");
+    return {
+        async run(statement, parameters) {
+            const response = await ctx.fetch("openCypher", {
+                method: "POST",
+                idempotent: true,
+                allowStatus: [400, 500],
+                body: new URLSearchParams({ query: statement, parameters: JSON.stringify(parameters) }),
+            });
+            return neptuneResult(input, response);
+        },
+        profile: () => Promise.resolve(neptuneProfile()),
+        probe: async () => {
+            const status = await ctx.fetchJson("status");
+            return neptuneProfile(typeof status.dbEngineVersion === "string" ? status.dbEngineVersion : null);
+        },
+        close: () => Promise.resolve(),
+    };
+}
+//# sourceMappingURL=neptune-https.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"neptune-https.js","sourceRoot":"","sources":["../../../../../src/sources/cypher/transports/neptune-https.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvC,OAAO,EAAsB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAuC,MAAM,gBAAgB,CAAC;AASzG;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAkB,EAAE,SAAiB;IAC1D,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,SAAS,oCAAoC,EAAE;YACzF,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,MAAM,EAAE,MAAM;SACjB,CAAC,CAAC;IACP,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,IAAY;IAC/B,KAAK,IAAI,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAwB,CAAC;QAC9D,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAqB,EAAE,QAAkB;IACzE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC;IACzB,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAA6E,CAAC;IACzG,IAAI,KAAK,GAAwB,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9E,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAChB,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjB,WAAW,CACP,GAAG,CAAC,MAAM,EACV;YACI,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;YACxB,OAAO,EAAE,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE;YACrD,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,QAAQ,EAAE,IAAI,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG;SAC7E,EACD,MAAM,EACN,SAAS,CACZ,CAAC;IACN,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,aAAa,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE;YAC3E,GAAG,EAAE,MAAM;YACX,MAAM,EAAE,QAAQ,CAAC,MAAM;SAC1B,CAAC,CAAC;IACP,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,EAAE,mCAAmC,EAAE;YACzE,QAAQ,EAAE,MAAM;YAChB,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;SACpD,CAAC,CAAC;IACP,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAqB;IACvD,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAC/B,OAAO;QACH,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU;YAC3B,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE;gBAC3C,MAAM,EAAE,MAAM;gBACd,UAAU,EAAE,IAAI;gBAChB,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;gBACvB,IAAI,EAAE,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;aAC1F,CAAC,CAAC;YACH,OAAO,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAChD,KAAK,EAAE,KAAK,IAA4B,EAAE;YACtC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAA+B,QAAQ,CAAC,CAAC;YAC3E,OAAO,cAAc,CAAC,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtG,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;KACjC,CAAC;AACN,CAAC"}

package/dist/src/sources/cypher/transports/query-api.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The `query-api` transport (design section 12.2): Neo4j's `POST /db/{database}/query/v2`, on by
+ * default since Neo4j 5.26 and on Aura, with no driver. It asks for typed JSON, so integers keep
+ * every digit, and sends `accessMode: "Read"`, which the server enforces. CORS is open by default,
+ * so it works from a page on https.
+ */
+import { type Transport, type TransportInput } from "./transport.js";
+/**
+ * Make the transport.
+ * @param input - the context, params and mapper
+ * @returns the transport
+ */
+export declare function queryApiTransport(input: TransportInput): Transport;
+//# sourceMappingURL=query-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-api.d.ts","sourceRoot":"","sources":["../../../../../src/sources/cypher/transports/query-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAA0B,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAc7F;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAoElE"}

package/dist/src/sources/cypher/transports/query-api.js

@@ -0,0 +1,80 @@
+/**
+ * The `query-api` transport (design section 12.2): Neo4j's `POST /db/{database}/query/v2`, on by
+ * default since Neo4j 5.26 and on Aura, with no driver. It asks for typed JSON, so integers keep
+ * every digit, and sends `accessMode: "Read"`, which the server enforces. CORS is open by default,
+ * so it works from a page on https.
+ */
+import { originOf } from "../../credentials.js";
+import { failOn } from "../../fail.js";
+import { neo4jProfile } from "../profiles.js";
+import { fromTypedJson } from "../types-map.js";
+import { parseJson, serverError } from "./transport.js";
+/** The media type of Neo4j's typed JSON. */
+const TYPED_JSON = "application/vnd.neo4j.query.v1.1";
+/** The statuses whose JSON body says what went wrong. */
+const ERROR_STATUSES = [400, 404, 500];
+/**
+ * Make the transport.
+ * @param input - the context, params and mapper
+ * @returns the transport
+ */
+export function queryApiTransport(input) {
+    const { ctx, params, m } = input;
+    const database = params.database ?? "neo4j";
+    const path = `db/${encodeURIComponent(database)}/query/v2`;
+    const origin = ctx.endpoint === null ? "" : originOf(ctx.endpoint);
+    const run = async (statement, parameters) => {
+        const response = await ctx.fetch(path, {
+            method: "POST",
+            idempotent: true,
+            allowStatus: ERROR_STATUSES,
+            headers: { "Content-Type": "application/json", Accept: TYPED_JSON },
+            body: JSON.stringify({ statement, parameters, accessMode: "Read" }),
+        });
+        const body = parseJson(await response.text());
+        const first = body?.errors?.[0];
+        if (first !== undefined) {
+            serverError(ctx.report, {
+                code: first.code ?? null,
+                message: first.message ?? "",
+                status: response.status,
+                showable: response.status >= 400 && response.status < 500,
+            }, origin, params.database);
+        }
+        if (response.status === 404) {
+            // no Query API here: a Neo4j before 5.26 answers 404, and speaks only Bolt
+            failOn(ctx.report, "E_SOURCE_NOT_FOUND", `${origin} has no Query API at ${path}`, {
+                what: "url",
+                value: `${origin}/${path}`,
+            });
+        }
+        if (!response.ok) {
+            failOn(ctx.report, "E_FETCH", `${origin} answered ${String(response.status)}`, {
+                url: `${origin}/${path}`,
+                status: response.status,
+            });
+        }
+        if (body?.data === undefined) {
+            failOn(ctx.report, "E_SOURCE_RESPONSE", "the Query API answer has no data", {
+                expected: "json",
+                contentType: response.headers.get("content-type"),
+            });
+        }
+        const { fields, values } = body.data;
+        return { fields, rows: values.map((row) => row.map((v, i) => fromTypedJson(v, fields[i] ?? "", m))) };
+    };
+    return {
+        run,
+        // the Query API exists from Neo4j 5.26, so ids are elementId()
+        profile: () => Promise.resolve(neo4jProfile(null)),
+        probe: async () => {
+            const res = await run("CALL dbms.components() YIELD name, versions, edition RETURN name, versions, edition", {});
+            const kernel = res.rows.find((r) => r[0] === "Neo4j Kernel") ?? res.rows[0];
+            const versions = kernel?.[1];
+            const version = Array.isArray(versions) && typeof versions[0] === "string" ? versions[0] : null;
+            return neo4jProfile(version);
+        },
+        close: () => Promise.resolve(),
+    };
+}
+//# sourceMappingURL=query-api.js.map

package/dist/src/sources/cypher/transports/query-api.js.map

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

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

@@ -0,0 +1,78 @@
+/**
+ * What every Cypher transport is (design section 12.2): something that runs one statement with
+ * its parameters and returns mapped rows, knows the server's profile, and closes. Also the one
+ * place a server's own error code becomes a source issue code.
+ */
+import { type ImportReportBuilder } from "../../../common/report.js";
+import { type SourceContext } from "../../types.js";
+import { type QueryResult } from "../flatten.js";
+import { type CypherParams } from "../params.js";
+import { type CypherProfile } from "../profiles.js";
+import { type MapContext } from "../types-map.js";
+/** One way a Cypher statement travels to a server. Internal. */
+export interface Transport {
+    /**
+     * Run one read-only statement.
+     * @param statement - the statement
+     * @param parameters - its parameters, sent separately
+     * @returns the mapped result
+     */
+    run(statement: string, parameters: Readonly<Record<string, unknown>>): Promise<QueryResult>;
+    /**
+     * The server's profile, detected once.
+     * @returns the profile
+     */
+    profile(): Promise<CypherProfile>;
+    /**
+     * The server facts `probe` reports, which may cost a request.
+     * @returns the profile with its version filled in where the server says it
+     */
+    probe(): Promise<CypherProfile>;
+    /** Release the connection. */
+    close(): Promise<void>;
+}
+/** What a transport is made from. */
+export interface TransportInput {
+    /** The load's context. */
+    readonly ctx: SourceContext;
+    /** The params, with defaults. */
+    readonly params: CypherParams;
+    /** The type mapper's context. */
+    readonly m: MapContext;
+}
+/** What a server said about a failed statement. */
+interface ServerError {
+    /** The service's own code, or null. */
+    readonly code: string | null;
+    /** Its message, or "". */
+    readonly message: string;
+    /** The HTTP status, or null over Bolt. */
+    readonly status: number | null;
+    /** Whether the message came from a JSON 4xx body (or a Bolt client error), so a report may keep it. */
+    readonly showable: boolean;
+}
+/**
+ * Raise the source issue a server error is: a login failure, a refusal, a server timeout, a
+ * missing database, or E_SOURCE_QUERY with the line and column the message names.
+ * @param report - the load's report
+ * @param err - what the server said
+ * @param origin - the origin that answered
+ * @param database - the database asked for, if any
+ * @returns never; it throws
+ */
+export declare function serverError(report: ImportReportBuilder, err: ServerError, origin: string, database: string | undefined): never;
+/**
+ * The value of a response body as JSON, or null when it is not JSON.
+ * @param text - the body
+ * @returns the parsed value, or null
+ */
+export declare function parseJson(text: string): unknown;
+/**
+ * The fields and rows of a result given as one object per row (Neptune's `results`).
+ * @param results - the row objects
+ * @param map - maps one value, given its column
+ * @returns the result
+ */
+export declare function objectRows(results: readonly Readonly<Record<string, unknown>>[], map: (v: unknown, column: string) => unknown): QueryResult;
+export {};
+//# sourceMappingURL=transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../../src/sources/cypher/transports/transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,gEAAgE;AAChE,MAAM,WAAW,SAAS;IACtB;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5F;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAClC;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,8BAA8B;IAC9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC;CAC1B;AAKD,mDAAmD;AACnD,UAAU,WAAW;IACjB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uGAAuG;IACvG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACvB,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC7B,KAAK,CAmCP;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAM/C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACtB,OAAO,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,EACrD,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,GAC7C,WAAW,CAGb"}