@graphty/graph-io 0.3.47 → 0.3.48

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

@@ -0,0 +1,405 @@
+/**
+ * `@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 { throwIfAborted } from "../../common/input.js";
+import { ImportError } from "../../types.js";
+import { SOURCE_ISSUE } from "../codes.js";
+import { defineSource } from "../define.js";
+import { failOn } from "../fail.js";
+import { CYPHER_SOURCE_ID, NEO4J_SOURCE_ID, NEPTUNE_SOURCE_ID } from "../ids.js";
+import { sha256Hex } from "../sigv4.js";
+import { CYPHER_DESCRIPTOR, NEO4J_DESCRIPTOR, NEPTUNE_DESCRIPTOR } from "./descriptor.js";
+import { canonicalRows, Collector, compareText, requireGraph, writeCollected } from "./flatten.js";
+import { neo4jProfile, neptuneProfile, serverFacts } from "./profiles.js";
+import { checkedInteger, counts, DEFAULT_PAGE_SIZE, edgePage, MAX_DEPTH, MAX_PAGE_SIZE, neighborhood, nodePage, quoted, } from "./query-builder.js";
+import { boltTransport } from "./transports/bolt.js";
+import { neptuneAnalyticsTransport } from "./transports/neptune-analytics.js";
+import { neptuneHttpsTransport } from "./transports/neptune-https.js";
+import { queryApiTransport } from "./transports/query-api.js";
+export { CYPHER_DESCRIPTOR, NEO4J_DESCRIPTOR, NEPTUNE_DESCRIPTOR } from "./descriptor.js";
+export { cypherIdentifier } from "./query-builder.js";
+/** The directions an expansion may follow. */
+const DIRECTIONS = new Set(["out", "in", "both"]);
+/**
+ * A list parameter: an array, or one value. A string is one item, never split, since an id or a
+ * label may hold any character.
+ * @param value - the value
+ * @param name - the parameter
+ * @param report - the load's report
+ * @returns the items
+ */
+function listParam(value, name, report) {
+    if (value === undefined || value === null) {
+        return [];
+    }
+    if (Array.isArray(value)) {
+        return value;
+    }
+    if (typeof value === "string" || typeof value === "number") {
+        return [value];
+    }
+    return failOn(report, "E_SOURCE_PARAM", `parameter ${name}: not a list`, { name, reason: "type" });
+}
+/**
+ * The transport a load uses: the params' choice, else the endpoint's scheme, else the preset's.
+ * @param params - the params
+ * @param ctx - the context
+ * @param preset - the preset
+ * @returns the transport name
+ */
+function transportName(params, ctx, preset) {
+    if (params.transport !== undefined) {
+        return params.transport;
+    }
+    const scheme = ctx.endpoint?.protocol ?? "";
+    if (scheme.startsWith("bolt") || scheme.startsWith("neo4j")) {
+        return "bolt";
+    }
+    if (ctx.endpoint?.hostname.endsWith(".neptune-graph.amazonaws.com") === true) {
+        return "neptune-analytics";
+    }
+    return preset.transport;
+}
+/** One load's connection, filters and profile. */
+class Reader {
+    /**
+     * Set up a read.
+     * @param transport - the transport
+     * @param params - the params
+     * @param ctx - the context
+     */
+    constructor(transport, params, ctx) {
+        this.transport = transport;
+        this.params = params;
+        this.ctx = ctx;
+        this.known = null;
+        this.degree = true;
+        const { report } = ctx;
+        this.idProperty = params.idProperty ?? null;
+        this.filters = {
+            labels: listParam(params.labels, "labels", report).map((l) => quoted(l, "labels", report)),
+            relationshipTypes: listParam(params.relationshipTypes, "relationshipTypes", report).map((t) => quoted(t, "relationshipTypes", report)),
+            idProperty: this.idProperty === null ? null : quoted(this.idProperty, "idProperty", report),
+        };
+    }
+    /**
+     * The server's profile: the params' choice, else the transport's detection.
+     * @returns the profile
+     */
+    async profile() {
+        if (this.known === null) {
+            const detected = await this.transport.profile();
+            this.known = detected;
+            if (this.params.profile === "neptune") {
+                this.known = neptuneProfile(detected.version);
+            }
+            else if (this.params.profile === "neo4j" && detected.name !== "neo4j") {
+                this.known = neo4jProfile(detected.version);
+            }
+        }
+        return this.known;
+    }
+    /**
+     * Run a generated statement with the degree hint, and without it once if the server refuses it.
+     * @param build - builds the statement, with or without the hint
+     * @param parameters - its parameters
+     * @returns the result, collected
+     */
+    async generated(build, parameters) {
+        let result;
+        try {
+            result = await this.transport.run(build(this.degree), parameters);
+        }
+        catch (err) {
+            if (!this.degree || !(err instanceof ImportError) || err.issue?.code !== SOURCE_ISSUE.E_SOURCE_QUERY) {
+                throw err;
+            }
+            // the pattern comprehension of the degree hint is not every server's (Neptune, unverified)
+            this.degree = false;
+            result = await this.transport.run(build(false), parameters);
+        }
+        const collected = new Collector();
+        collected.add(result, true);
+        return { collected, rows: result.rows, fields: result.fields };
+    }
+    /**
+     * The pages of a read, as `mode` asks.
+     * @param cursor - where to resume
+     * @yields one page at a time
+     */
+    async *pages(cursor) {
+        const { params, ctx } = this;
+        const { report } = ctx;
+        const mode = params.mode ?? (typeof params.query === "string" && params.query !== "" ? "query" : "all");
+        if (mode === "query") {
+            if (typeof params.query !== "string" || params.query.trim() === "") {
+                failOn(report, "E_SOURCE_PARAM", "mode query needs a query", { name: "query", reason: "required" });
+            }
+            const result = await this.transport.run(params.query, params.parameters ?? {});
+            const collected = new Collector();
+            collected.add(result, false);
+            requireGraph(result, collected, report);
+            yield { collected, next: null };
+            return;
+        }
+        const profile = await this.profile();
+        if (mode === "neighborhood") {
+            const ids = listParam(params.ids, "ids", report);
+            if (ids.length === 0) {
+                failOn(report, "E_SOURCE_PARAM", "mode neighborhood needs ids", { name: "ids", reason: "required" });
+            }
+            const shape = {
+                depth: checkedInteger(params.depth ?? 1, "depth", 1, MAX_DEPTH, report),
+                direction: "both",
+                limit: ctx.limits.maxNodes === undefined
+                    ? null
+                    : checkedInteger(ctx.limits.maxNodes, "maxNodes", 1, Number.MAX_SAFE_INTEGER, report),
+            };
+            const { collected } = await this.generated((d) => neighborhood(profile, this.filters, shape, d), { ids });
+            yield { collected, next: null };
+            return;
+        }
+        yield* this.everything(profile, cursor);
+    }
+    /**
+     * Mode "all": the nodes, then the relationships with their ends, each paged by keyset on the
+     * id expression (never SKIP), so a page is stable under unrelated writes.
+     * @param profile - the server's profile
+     * @param cursor - where to resume
+     * @yields one page at a time
+     */
+    async *everything(profile, cursor) {
+        const { params, ctx } = this;
+        const size = checkedInteger(params.pageSize ?? DEFAULT_PAGE_SIZE, "pageSize", 1, MAX_PAGE_SIZE, ctx.report);
+        let phase = cursor?.phase === "edges" ? "edges" : "nodes";
+        let after = cursor?.after ?? null;
+        const total = params.countFirst === true && cursor === null ? await this.total() : undefined;
+        for (;;) {
+            const nodes = phase === "nodes";
+            const { collected, rows, fields } = await this.generated((d) => nodes
+                ? nodePage(profile, this.filters, size, after !== null, d)
+                : edgePage(profile, this.filters, size, after !== null), after === null ? {} : { after });
+            const next = nextCursor(phase, rows, fields, Number(size));
+            yield { collected, next };
+            const { counts: done } = ctx.report;
+            ctx.progress(done.nodes + done.edges, total, "items");
+            if (next === null) {
+                return;
+            }
+            phase = next.phase === "edges" ? "edges" : "nodes";
+            after = next.after ?? null;
+        }
+    }
+    /**
+     * How many nodes and relationships the filters match, for progress.
+     * @returns the count
+     */
+    async total() {
+        const [n, r] = counts(this.filters);
+        const [a, b] = await Promise.all([this.transport.run(n, {}), this.transport.run(r, {})]);
+        return Number(a.rows[0]?.[0] ?? 0) + Number(b.rows[0]?.[0] ?? 0);
+    }
+    /**
+     * The server facts and validators of what was read.
+     * @param lines - the canonical rows
+     * @returns the server facts and validators
+     */
+    async facts(lines) {
+        const profile = await this.profile();
+        const contentHash = await sha256Hex([...lines].sort(compareText).join("\n"));
+        return {
+            server: serverFacts(profile),
+            validators: profile.version === null ? { contentHash } : { contentHash, serverVersion: profile.version },
+        };
+    }
+}
+/**
+ * Where mode "all" resumes after a page: the same phase after the page's last key while pages are
+ * full, then the relationships from the start, then nothing.
+ * @param phase - the page's phase
+ * @param rows - the page's rows
+ * @param fields - the page's field names
+ * @param size - the page size
+ * @returns the next cursor, or null at the end
+ */
+function nextCursor(phase, rows, fields, size) {
+    const last = rows.at(-1)?.[fields.indexOf("key")];
+    const key = typeof last === "string" || typeof last === "number" ? last : null;
+    if (rows.length >= size && key !== null) {
+        return { phase, after: key };
+    }
+    return phase === "nodes" ? { phase: "edges", after: null } : null;
+}
+/**
+ * Open a read: pick the transport, check what it needs, connect.
+ * @param params - the params
+ * @param ctx - the context
+ * @param preset - the preset
+ * @returns the reader
+ */
+async function open(params, ctx, preset) {
+    throwIfAborted(ctx.signal);
+    const input = { ctx, params, m: { long: params.long ?? "f64", report: ctx.report } };
+    const name = transportName(params, ctx, preset);
+    let transport;
+    switch (name) {
+        case "bolt":
+            transport = await boltTransport(input);
+            break;
+        case "neptune-https":
+            transport = neptuneHttpsTransport(input);
+            break;
+        case "neptune-analytics":
+            transport = neptuneAnalyticsTransport(input);
+            break;
+        default:
+            transport = queryApiTransport(input);
+            break;
+    }
+    try {
+        return new Reader(transport, params, ctx);
+    }
+    catch (err) {
+        await transport.close();
+        throw err;
+    }
+}
+/**
+ * Run something with a reader, closing it after.
+ * @param params - the params
+ * @param ctx - the context
+ * @param preset - the preset
+ * @param body - what to do
+ * @returns what the body returned
+ */
+async function withReader(params, ctx, preset, body) {
+    const reader = await open(params, ctx, preset);
+    try {
+        return await body(reader);
+    }
+    finally {
+        await reader.transport.close();
+    }
+}
+/**
+ * Make the Cypher source or one of its presets.
+ * @param preset - the id, descriptor and default transport
+ * @returns the source
+ */
+function cypher(preset) {
+    return defineSource({
+        id: preset.id,
+        descriptor: preset.descriptor,
+        import: (params, sink, ctx) => withReader(params, ctx, preset, async (reader) => {
+            const lines = [];
+            let next = null;
+            for await (const page of reader.pages(ctx.cursor)) {
+                writeCollected(page.collected, sink, reader.idProperty, ctx.report, ctx.signal);
+                lines.push(...canonicalRows(page.collected, reader.idProperty));
+                ({ next } = page);
+                if (next !== null && ctx.limits.reached()) {
+                    break;
+                }
+            }
+            return ctx.finish({ next, ...(await reader.facts(lines)) });
+        }),
+        expand: (request, sink, ctx) => withReader(request.params, ctx, preset, (reader) => expand(reader, request, sink)),
+        probe: (params, ctx) => withReader(params, ctx, preset, async (reader) => {
+            const profile = await reader.transport.probe();
+            return { ok: true, server: serverFacts(profile) };
+        }),
+        validate: (params, seen, ctx) => withReader(params, ctx, preset, async (reader) => {
+            const lines = [];
+            for await (const page of reader.pages(null)) {
+                lines.push(...canonicalRows(page.collected, reader.idProperty));
+            }
+            const { validators } = await reader.facts(lines);
+            let status = "unverifiable";
+            if (seen.contentHash !== undefined) {
+                status = seen.contentHash === validators.contentHash ? "current" : "changed";
+            }
+            return { status, via: "hash", validators };
+        }),
+    });
+}
+/**
+ * Fetch the neighborhood of some nodes into the sink.
+ * @param reader - the reader
+ * @param request - the seeds and how far to go
+ * @param sink - where to write
+ * @returns the report
+ */
+async function expand(reader, request, sink) {
+    const { ctx } = reader;
+    const { report } = ctx;
+    if (request.ids.length === 0) {
+        failOn(report, "E_SOURCE_PARAM", "an expansion needs seed ids", { name: "ids", reason: "required" });
+    }
+    const direction = request.direction ?? "both";
+    if (!DIRECTIONS.has(direction)) {
+        failOn(report, "E_SOURCE_PARAM", "direction must be out, in or both", { name: "direction", reason: "enum" });
+    }
+    const limit = request.limit ?? ctx.limits.maxNodes;
+    const after = ctx.cursor?.after ?? null;
+    const shape = {
+        depth: checkedInteger(request.depth ?? 1, "depth", 1, MAX_DEPTH, report),
+        direction,
+        limit: limit === undefined ? null : checkedInteger(limit, "limit", 1, Number.MAX_SAFE_INTEGER, report),
+        after: after !== null,
+    };
+    const filters = request.relationshipTypes === undefined
+        ? reader.filters
+        : {
+            ...reader.filters,
+            relationshipTypes: request.relationshipTypes.map((t) => quoted(t, "relationshipTypes", report)),
+        };
+    const profile = await reader.profile();
+    const { collected, rows, fields } = await reader.generated((d) => neighborhood(profile, filters, shape, d), {
+        ids: request.ids,
+        ...(after === null ? {} : { after }),
+    });
+    writeCollected(collected, sink, reader.idProperty, report, ctx.signal);
+    const { server } = await reader.facts([]);
+    // A full page may have more behind it: hand back where the next one starts.
+    const last = rows.at(-1)?.[fields.indexOf("key")];
+    const full = shape.limit !== null && rows.length >= Number(shape.limit);
+    const next = full && (typeof last === "string" || typeof last === "number") ? { after: last } : null;
+    return ctx.finish({ server, next });
+}
+/**
+ * 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 const cypherSource = cypher({
+    id: CYPHER_SOURCE_ID,
+    descriptor: CYPHER_DESCRIPTOR,
+    transport: "query-api",
+});
+/**
+ * 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 const neo4jSource = cypher({
+    id: NEO4J_SOURCE_ID,
+    descriptor: NEO4J_DESCRIPTOR,
+    transport: "query-api",
+});
+/**
+ * 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 const neptuneSource = cypher({
+    id: NEPTUNE_SOURCE_ID,
+    descriptor: NEPTUNE_DESCRIPTOR,
+    transport: "neptune-https",
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/sources/cypher/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAqB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAWxC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnG,OAAO,EAAsB,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9F,OAAO,EACH,cAAc,EACd,MAAM,EACN,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,aAAa,EACb,YAAY,EACZ,QAAQ,EAER,MAAM,GACT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1F,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAuBtD,8CAA8C;AAC9C,MAAM,UAAU,GAAwB,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvE;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,KAAc,EAAE,IAAY,EAAE,MAA2B;IACxE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAkB,CAAC;IAC9B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACzD,OAAO,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,aAAa,IAAI,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AACvG,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,MAAoB,EAAE,GAAkB,EAAE,MAAc;IAC3E,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,SAAS,CAAC;IAC5B,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC5C,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,8BAA8B,CAAC,KAAK,IAAI,EAAE,CAAC;QAC3E,OAAO,mBAAmB,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC,SAAS,CAAC;AAC5B,CAAC;AAED,kDAAkD;AAClD,MAAM,MAAM;IAOR;;;;;OAKG;IACH,YACa,SAAoB,EACpB,MAAoB,EACpB,GAAkB;QAFlB,cAAS,GAAT,SAAS,CAAW;QACpB,WAAM,GAAN,MAAM,CAAc;QACpB,QAAG,GAAH,GAAG,CAAe;QAfvB,UAAK,GAAyB,IAAI,CAAC;QACnC,WAAM,GAAG,IAAI,CAAC;QAgBlB,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG;YACX,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC1F,iBAAiB,EAAE,SAAS,CAAC,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1F,MAAM,CAAC,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,CACzC;YACD,UAAU,EAAE,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,CAAC;SAC9F,CAAC;IACN,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO;QACT,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YAChD,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACtB,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACpC,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClD,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,OAAO,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACtE,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAChD,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CACX,KAAkC,EAClC,UAA6C;QAE7C,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACD,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,YAAY,WAAW,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,IAAI,KAAK,YAAY,CAAC,cAAc,EAAE,CAAC;gBACnG,MAAM,GAAG,CAAC;YACd,CAAC;YACD,2FAA2F;YAC3F,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YACpB,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;QAClC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACnE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,CAAC,KAAK,CAAC,MAA2B;QACpC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC7B,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACxG,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACnB,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACjE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YACxG,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YAC/E,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;YAClC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC7B,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YACxC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAChC,OAAO;QACX,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAsB,CAAC;YACtE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnB,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YACzG,CAAC;YACD,MAAM,KAAK,GAAG;gBACV,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC;gBACvE,SAAS,EAAE,MAAe;gBAC1B,KAAK,EACD,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS;oBAC7B,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC;aAChG,CAAC;YACF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YAC1G,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAChC,OAAO;QACX,CAAC;QACD,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,CAAC,UAAU,CAAC,OAAsB,EAAE,MAA2B;QACzE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC7B,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,QAAQ,IAAI,iBAAiB,EAAE,UAAU,EAAE,CAAC,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5G,IAAI,KAAK,GAAsB,MAAM,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7E,IAAI,KAAK,GAAqC,MAAM,EAAE,KAAK,IAAI,IAAI,CAAC;QACpE,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7F,SAAS,CAAC;YACN,MAAM,KAAK,GAAG,KAAK,KAAK,OAAO,CAAC;YAChC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CACpD,CAAC,CAAC,EAAE,EAAE,CACF,KAAK;gBACD,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC;gBAC1D,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC,EAC/D,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAClC,CAAC;YACF,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3D,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YAC1B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;YACpC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACtD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAChB,OAAO;YACX,CAAC;YACD,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACnD,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;QAC/B,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,KAAK;QACf,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QACzF,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,KAAe;QACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7E,OAAO;YACH,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC;YAC5B,UAAU,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,CAAC,OAAO,EAAE;SAC3G,CAAC;IACN,CAAC;CACJ;AAED;;;;;;;;GAQG;AACH,SAAS,UAAU,CACf,KAAwB,EACxB,IAAqC,EACrC,MAAyB,EACzB,IAAY;IAEZ,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/E,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACtC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACjC,CAAC;IACD,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,IAAI,CAAC,MAAoB,EAAE,GAAkB,EAAE,MAAc;IACxE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAmB,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;IACrG,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAChD,IAAI,SAAoB,CAAC;IACzB,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,MAAM;YACP,SAAS,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;YACvC,MAAM;QACV,KAAK,eAAe;YAChB,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;YACzC,MAAM;QACV,KAAK,mBAAmB;YACpB,SAAS,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;YAC7C,MAAM;QACV;YACI,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACrC,MAAM;IACd,CAAC;IACD,IAAI,CAAC;QACD,OAAO,IAAI,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QACxB,MAAM,GAAG,CAAC;IACd,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,UAAU,CACrB,MAAoB,EACpB,GAAkB,EAClB,MAAc,EACd,IAAoC;IAEpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;YAAS,CAAC;QACP,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACnC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAS,MAAM,CAAC,MAAc;IAC1B,OAAO,YAAY,CAAe;QAC9B,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAC1B,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAyB,EAAE;YACpE,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,IAAI,GAAwB,IAAI,CAAC;YACrC,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChD,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;gBAChF,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;gBAChE,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;gBAClB,IAAI,IAAI,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;oBACxC,MAAM;gBACV,CAAC;YACL,CAAC;YACD,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC,CAAC;QACN,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAC3B,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACtF,KAAK,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CACnB,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAwB,EAAE;YACnE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAC/C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,CAAC,CAAC;QACN,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAC5B,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAA4B,EAAE;YACvE,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1C,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YACpE,CAAC;YACD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACjD,IAAI,MAAM,GAA8B,cAAc,CAAC;YACvD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBACjC,MAAM,GAAG,IAAI,CAAC,WAAW,KAAK,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YACjF,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC/C,CAAC,CAAC;KACT,CAAC,CAAC;AACP,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,MAAM,CAAC,MAAc,EAAE,OAAoC,EAAE,IAAe;IACvF,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACvB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACzG,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC9C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,mCAAmC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACjH,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;IACnD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,IAAI,IAAI,CAAC;IACxC,MAAM,KAAK,GAAG;QACV,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC;QACxE,SAAS;QACT,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC;QACtG,KAAK,EAAE,KAAK,KAAK,IAAI;KACxB,CAAC;IACF,MAAM,OAAO,GACT,OAAO,CAAC,iBAAiB,KAAK,SAAS;QACnC,CAAC,CAAC,MAAM,CAAC,OAAO;QAChB,CAAC,CAAC;YACI,GAAG,MAAM,CAAC,OAAO;YACjB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,CAAC;SAClG,CAAC;IACZ,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACvC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE;QACxG,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KACvC,CAAC,CAAC;IACH,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1C,4EAA4E;IAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACrG,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAA8B,MAAM,CAAC;IAC1D,EAAE,EAAE,gBAAgB;IACpB,UAAU,EAAE,iBAAiB;IAC7B,SAAS,EAAE,WAAW;CACzB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAA8B,MAAM,CAAC;IACzD,EAAE,EAAE,eAAe;IACnB,UAAU,EAAE,gBAAgB;IAC5B,SAAS,EAAE,WAAW;CACzB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAA8B,MAAM,CAAC;IAC3D,EAAE,EAAE,iBAAiB;IACrB,UAAU,EAAE,kBAAkB;IAC9B,SAAS,EAAE,eAAe;CAC7B,CAAC,CAAC"}

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

@@ -0,0 +1,40 @@
+/**
+ * The parameters of the Cypher source and its `neo4j` and `neptune` presets (design section 12.2).
+ * Experimental. The Cypher work may add optional fields only.
+ */
+import { type NodeId } from "@graphty/graph-format";
+/**
+ * What to read from an openCypher server. Experimental.
+ * @category Network sources
+ */
+export interface CypherParams {
+    /** The caller's query; without one a query is generated from `mode`. */
+    readonly query?: string | undefined;
+    /** The query's parameters, sent separately, never spliced. @defaultValue {} */
+    readonly parameters?: Readonly<Record<string, unknown>> | undefined;
+    /** "query" (the caller's), "all" (the whole database, paged) or "neighborhood" (around `ids`). */
+    readonly mode?: "query" | "all" | "neighborhood" | undefined;
+    /** The seed ids of "neighborhood". */
+    readonly ids?: readonly NodeId[] | undefined;
+    /** Hops of "neighborhood", 1 to 10. @defaultValue 1 */
+    readonly depth?: number | undefined;
+    /** Only nodes with these labels (generated queries). */
+    readonly labels?: readonly string[] | undefined;
+    /** Only relationships of these types (generated queries). */
+    readonly relationshipTypes?: readonly string[] | undefined;
+    /** Key nodes on this property (`uuid`) instead of the server's id. */
+    readonly idProperty?: string | undefined;
+    /** The database; default the server's default. */
+    readonly database?: string | undefined;
+    /** How the query travels; the presets set it. */
+    readonly transport?: "query-api" | "bolt" | "neptune-https" | "neptune-analytics" | undefined;
+    /** The server's profile; "auto" detects it. @defaultValue "auto" */
+    readonly profile?: "neo4j" | "neptune" | "auto" | undefined;
+    /** Integers past 2^53: "f64" (rounded, with a warning) or "string". @defaultValue "f64" */
+    readonly long?: "f64" | "string" | undefined;
+    /** Run a count first, for a progress total. @defaultValue false */
+    readonly countFirst?: boolean | undefined;
+    /** Rows per page of mode "all", 1 to 100000. A load stops between pages, so a cap overshoots by at most one page. @defaultValue 1000 */
+    readonly pageSize?: number | undefined;
+}
+//# sourceMappingURL=params.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../../../src/sources/cypher/params.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,wEAAwE;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IACpE,kGAAkG;IAClG,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,cAAc,GAAG,SAAS,CAAC;IAC7D,sCAAsC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7C,uDAAuD;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,6DAA6D;IAC7D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3D,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,eAAe,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAC9F,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5D,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC7C,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,wIAAwI;IACxI,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C"}

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

@@ -0,0 +1,6 @@
+/**
+ * The parameters of the Cypher source and its `neo4j` and `neptune` presets (design section 12.2).
+ * Experimental. The Cypher work may add optional fields only.
+ */
+export {};
+//# sourceMappingURL=params.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../../../src/sources/cypher/params.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

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

@@ -0,0 +1,44 @@
+/**
+ * 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 facts of one server the Cypher source talks to. */
+export interface CypherProfile {
+    /** "neo4j" or "neptune". */
+    readonly name: "neo4j" | "neptune";
+    /** true: ids are `elementId(n)` (Neo4j 5 and later); false: `id(n)` (Neo4j before 5, Neptune's `~id`). */
+    readonly elementIds: boolean;
+    /** The product, as the server names it. */
+    readonly product: string;
+    /** The server's version, when known. */
+    readonly version: string | null;
+    /** "enforced": the server refuses writes in this session; "not-enforced": nothing in the request does. */
+    readonly readOnly: "enforced" | "not-enforced";
+}
+/**
+ * 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 declare function neo4jProfile(version: string | null, product?: string): CypherProfile;
+/**
+ * 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 declare function profileFromAgent(agent: string): CypherProfile;
+/**
+ * The Neptune profile: ids are `id(n)`, the `~id` string, never reused.
+ * @param version - the engine version, when known
+ * @returns the profile
+ */
+export declare function neptuneProfile(version?: string | null): CypherProfile;
+/**
+ * The server facts of a profile, as `probe` and `report.source.server` give them.
+ * @param profile - the profile
+ * @returns the facts
+ */
+export declare function serverFacts(profile: CypherProfile): Readonly<Record<string, string>>;
+//# sourceMappingURL=profiles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../../src/sources/cypher/profiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC1B,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,0GAA0G;IAC1G,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0GAA0G;IAC1G,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,cAAc,CAAC;CAClD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,SAAU,GAAG,aAAa,CASrF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAY7D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAOpF"}

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