@graphty/graph-io 0.3.48 → 0.3.50

package/dist/src/sources/sigv4.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sigv4.d.ts","sourceRoot":"","sources":["../../../src/sources/sigv4.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAoExD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEvD;AAyDD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC7B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,eAAe,EACxB,GAAG,GAAE,IAAiB,GACvB,OAAO,CAAC,OAAO,CAAC,CAqDlB"}
+{"version":3,"file":"sigv4.d.ts","sourceRoot":"","sources":["../../../src/sources/sigv4.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAoExD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpE;AAyDD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC7B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,eAAe,EACxB,GAAG,GAAE,IAAiB,GACvB,OAAO,CAAC,OAAO,CAAC,CAqDlB"}

package/dist/src/sources/sigv4.js

@@ -66,12 +66,14 @@ async function sha256(data) {
     return hex(await s.digest("SHA-256", data));
 }
 /**
- * SHA-256 of a text's UTF-8 bytes, as lowercase hex (the Cypher source's content hash).
- * @param text - the text
+ * SHA-256 as 64 lowercase hexadecimal digits: of bytes exactly as given, or of a text's UTF-8 bytes
+ * (the Cypher source's content hash, a project file's record of a file it loaded). Web Crypto where
+ * there is one, else plain JavaScript (a page that is not a secure context). Experimental.
+ * @param data - the bytes or the text
  * @returns the digest
  */
-export function sha256Hex(text) {
-    return sha256(utf8(text));
+export function sha256Hex(data) {
+    return sha256(typeof data === "string" ? utf8(data) : data);
 }
 /**
  * HMAC-SHA-256.

package/dist/src/sources/sigv4.js.map

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

package/dist/src/sources/sparql/descriptor.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The SPARQL source's descriptor: catalog data, available without loading the source's code.
+ */
+import { type SourceDescriptor } from "../types.js";
+/**
+ * The descriptor of the `sparql` source. Experimental.
+ * @category Network sources
+ */
+export declare const SPARQL_DESCRIPTOR: SourceDescriptor;
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/src/sources/sparql/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../../src/sources/sparql/descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAapD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,gBA6C9B,CAAC"}

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

@@ -0,0 +1,64 @@
+/**
+ * The SPARQL source's descriptor: catalog data, available without loading the source's code.
+ */
+/** A small Wikidata query: physics Nobel laureates and their doctoral advisors. */
+const WIKIDATA_ADVISORS = `PREFIX wd: <http://www.wikidata.org/entity/>
+PREFIX wdt: <http://www.wikidata.org/prop/direct/>
+PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
+CONSTRUCT { ?person wdt:P184 ?advisor . ?person rdfs:label ?name . ?advisor rdfs:label ?advisorName . }
+WHERE {
+  ?person wdt:P166 wd:Q38104 ; wdt:P184 ?advisor ; rdfs:label ?name .
+  ?advisor rdfs:label ?advisorName .
+  FILTER(lang(?name) = "en" && lang(?advisorName) = "en")
+}`;
+/**
+ * The descriptor of the `sparql` source. Experimental.
+ * @category Network sources
+ */
+export const SPARQL_DESCRIPTOR = Object.freeze({
+    plainName: "SPARQL endpoint",
+    kind: "sparql",
+    version: 1,
+    auth: ["basic", "bearer"],
+    authRequired: "optional",
+    features: ["expand", "probe", "validate", "page"],
+    params: [
+        { name: "query", plainName: "Query", type: "query", language: "sparql" },
+        {
+            name: "mode",
+            plainName: "Mode",
+            type: "enum",
+            values: [
+                { value: "query", label: "Query" },
+                { value: "all", label: "Everything" },
+                { value: "neighborhood", label: "Seed nodes" },
+            ],
+        },
+        { name: "ids", plainName: "Seed IRIs", type: "node-id" },
+        { name: "language", plainName: "Language", type: "string", advanced: true },
+        { name: "predicates", plainName: "Follow predicates", type: "string", advanced: true },
+        {
+            name: "pageSize",
+            plainName: "Page size",
+            type: "integer",
+            default: 1000,
+            min: 1,
+            max: 10000,
+            advanced: true,
+        },
+    ],
+    samples: [
+        {
+            id: "wikidata-physics-advisors",
+            plainName: "Wikidata: physics Nobel laureates and their advisors",
+            endpoint: "https://query.wikidata.org/sparql",
+            params: {
+                query: WIKIDATA_ADVISORS,
+                pageSize: 100,
+                language: "en",
+                predicates: ["http://www.wikidata.org/prop/direct/"], // NOSONAR(S5332): an RDF namespace IRI, never fetched; Wikidata's IRIs are http
+            },
+        },
+    ],
+});
+//# sourceMappingURL=descriptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.js","sourceRoot":"","sources":["../../../../src/sources/sparql/descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,mFAAmF;AACnF,MAAM,iBAAiB,GAAG;;;;;;;;EAQxB,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqB,MAAM,CAAC,MAAM,CAAC;IAC7D,SAAS,EAAE,iBAAiB;IAC5B,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;IACzB,YAAY,EAAE,UAAU;IACxB,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC;IACjD,MAAM,EAAE;QACJ,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE;QACxE;YACI,IAAI,EAAE,MAAM;YACZ,SAAS,EAAE,MAAM;YACjB,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE;gBACJ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;gBAClC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE;gBACrC,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE;aACjD;SACJ;QACD,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;QACxD,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3E,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACtF;YACI,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,WAAW;YACtB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,KAAK;YACV,QAAQ,EAAE,IAAI;SACjB;KACJ;IACD,OAAO,EAAE;QACL;YACI,EAAE,EAAE,2BAA2B;YAC/B,SAAS,EAAE,sDAAsD;YACjE,QAAQ,EAAE,mCAAmC;YAC7C,MAAM,EAAE;gBACJ,KAAK,EAAE,iBAAiB;gBACxB,QAAQ,EAAE,GAAG;gBACb,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,CAAC,sCAAsC,CAAC,EAAE,gFAAgF;aACzI;SACJ;KACJ;CACJ,CAAC,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * `@graphty/graph-io/sources/sparql`: the SPARQL source. It sends CONSTRUCT (or DESCRIBE) queries
+ * over the SPARQL 1.1 protocol (a form POST, N-Triples back) and reads the triples as a graph: an
+ * IRI or blank-node object is an edge from the subject (`type` is the predicate's local name,
+ * `predicate` the full IRI), a literal is an attribute of the subject named by the predicate's
+ * local name. Node ids are the IRIs.
+ *
+ * - Paging: the source adds `ORDER BY` (the template's variables) and `LIMIT` / `OFFSET` to the
+ *   caller's query, unless it sets its own; a load stops between pages at a cap and hands back
+ *   `{ offset }` as its cursor. A page is `pageSize` solutions, so its triple count varies; the
+ *   first empty page ends the load.
+ * - Expand: the triples of the seeds, `VALUES ?s { ... }` out and `VALUES ?o { ... }` in.
+ * - Validate: SHA-256 of the first page's triples.
+ *
+ * Experimental.
+ * @module @graphty/graph-io/sources/sparql
+ */
+import { type GraphSource } from "../types.js";
+import { type SparqlParams } from "./params.js";
+export { SPARQL_DESCRIPTOR } from "./descriptor.js";
+export { type SparqlParams } from "./params.js";
+/**
+ * The SPARQL source: CONSTRUCT or DESCRIBE queries against any SPARQL 1.1 endpoint, paged by
+ * `LIMIT` and `OFFSET`, expanded by `VALUES`, validated by a hash of the first page. Experimental.
+ * @category Network sources
+ */
+export declare const sparqlSource: GraphSource<SparqlParams>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/sources/sparql/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH,OAAO,EAEH,KAAK,WAAW,EAKnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAkThD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,YAAY,CAmBjD,CAAC"}

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

@@ -0,0 +1,327 @@
+/**
+ * `@graphty/graph-io/sources/sparql`: the SPARQL source. It sends CONSTRUCT (or DESCRIBE) queries
+ * over the SPARQL 1.1 protocol (a form POST, N-Triples back) and reads the triples as a graph: an
+ * IRI or blank-node object is an edge from the subject (`type` is the predicate's local name,
+ * `predicate` the full IRI), a literal is an attribute of the subject named by the predicate's
+ * local name. Node ids are the IRIs.
+ *
+ * - Paging: the source adds `ORDER BY` (the template's variables) and `LIMIT` / `OFFSET` to the
+ *   caller's query, unless it sets its own; a load stops between pages at a cap and hands back
+ *   `{ offset }` as its cursor. A page is `pageSize` solutions, so its triple count varies; the
+ *   first empty page ends the load.
+ * - Expand: the triples of the seeds, `VALUES ?s { ... }` out and `VALUES ?o { ... }` in.
+ * - Validate: SHA-256 of the first page's triples.
+ *
+ * Experimental.
+ * @module @graphty/graph-io/sources/sparql
+ */
+import { throwIfAborted } from "../../common/input.js";
+import { defineSource } from "../define.js";
+import { failOn } from "../fail.js";
+import { SPARQL_SOURCE_ID } from "../ids.js";
+import { sha256Hex } from "../sigv4.js";
+import { SPARQL_DESCRIPTOR } from "./descriptor.js";
+import { canonicalTriple, graphTriples, parseNTriples } from "./ntriples.js";
+import { allQuery, aroundQuery, iriTerm, pagedQuery, readQuery, validLanguage } from "./query.js";
+export { SPARQL_DESCRIPTOR } from "./descriptor.js";
+/** Solutions per page when the params name none. */
+const DEFAULT_PAGE_SIZE = 1000;
+/** Triples per hop of an expansion when the request names no limit. */
+const DEFAULT_EXPAND_LIMIT = 500;
+/** The deepest expansion, as for every built-in source. */
+const MAX_DEPTH = 10;
+/** What CONSTRUCT and DESCRIBE are asked to answer. */
+const ACCEPT_TRIPLES = "application/n-triples, text/plain;q=0.9";
+/**
+ * Send a query and read the answer as N-Triples.
+ * @param ctx - the context
+ * @param query - the query
+ * @returns the triples
+ */
+async function send(ctx, query) {
+    throwIfAborted(ctx.signal);
+    const response = await ctx.fetch(ctx.endpoint ?? "", {
+        method: "POST",
+        idempotent: true,
+        headers: { Accept: ACCEPT_TRIPLES, "Content-Type": "application/x-www-form-urlencoded" },
+        body: new URLSearchParams({ query }).toString(),
+        allowStatus: [400],
+    });
+    if (response.status === 400) {
+        const text = (await response.text()).trim().slice(0, 500);
+        failOn(ctx.report, "E_SOURCE_QUERY", "the endpoint refused the query", {
+            serverCode: null,
+            line: null,
+            column: null,
+            serverMessage: text === "" ? null : text,
+        });
+    }
+    const contentType = response.headers.get("content-type");
+    const notTriples = () => failOn(ctx.report, "E_SOURCE_RESPONSE", "the endpoint did not answer N-Triples", {
+        expected: "n-triples",
+        contentType,
+    });
+    if (contentType !== null && /html|json|xml/i.test(contentType)) {
+        notTriples();
+    }
+    const { triples, badLine } = parseNTriples(await response.text());
+    if (badLine !== null) {
+        notTriples();
+    }
+    return triples;
+}
+/**
+ * A whole-number param, checked.
+ * @param value - the value
+ * @param name - the param
+ * @param max - the largest allowed
+ * @param ctx - the context
+ * @returns the number
+ */
+function integer(value, name, max, ctx) {
+    if (!Number.isInteger(value) || value < 1 || value > max) {
+        failOn(ctx.report, "E_SOURCE_PARAM", `${name} is an integer from 1 to ${String(max)}`, {
+            name,
+            reason: "range",
+        });
+    }
+    return value;
+}
+/**
+ * The language filter, lowercase and checked, or "" for none.
+ * @param params - the params
+ * @param ctx - the context
+ * @returns the tag
+ */
+function languageOf(params, ctx) {
+    const language = params.language ?? "";
+    if (language !== "" && !validLanguage(language)) {
+        failOn(ctx.report, "E_SOURCE_PARAM", "language is a language tag", { name: "language", reason: "type" });
+    }
+    return language.toLowerCase();
+}
+/**
+ * The predicate prefixes generated queries follow, checked.
+ * @param params - the params
+ * @param ctx - the context
+ * @returns the prefixes; empty means every predicate
+ */
+function predicatesOf(params, ctx) {
+    const list = params.predicates ?? [];
+    const prefixes = typeof list === "string" ? [list] : list;
+    for (const p of prefixes) {
+        if (typeof p !== "string" || iriTerm(p) === null) {
+            failOn(ctx.report, "E_SOURCE_PARAM", "predicates are IRI prefixes", { name: "predicates", reason: "iri" });
+        }
+    }
+    return prefixes;
+}
+/**
+ * Seed ids as IRI terms; a blank node or anything else that is not an IRI is refused.
+ * @param ids - the ids
+ * @param name - the param, for the error
+ * @param ctx - the context
+ * @returns the terms
+ */
+function irisOf(ids, name, ctx) {
+    if (ids === undefined || ids.length === 0) {
+        failOn(ctx.report, "E_SOURCE_PARAM", `${name} needs at least one IRI`, { name, reason: "required" });
+    }
+    return ids.map((id) => iriTerm(id) ?? failOn(ctx.report, "E_SOURCE_PARAM", `${name}: not an IRI`, { name, reason: "iri" }));
+}
+/**
+ * What a load sends, from its mode.
+ * @param params - the params
+ * @param ctx - the context
+ * @returns the plan
+ */
+function planOf(params, ctx) {
+    const size = integer(params.pageSize ?? DEFAULT_PAGE_SIZE, "pageSize", 10000, ctx);
+    const filter = { language: languageOf(params, ctx), predicates: predicatesOf(params, ctx) };
+    const query = params.query?.trim() ?? "";
+    const mode = params.mode ?? (query === "" ? "all" : "query");
+    if (mode === "neighborhood") {
+        const iris = irisOf(params.ids, "ids", ctx);
+        return { at: (offset) => aroundQuery(iris, "both", filter, size, offset), paged: true };
+    }
+    if (mode === "all") {
+        return { at: (offset) => allQuery(filter, size, offset), paged: true };
+    }
+    if (query === "") {
+        failOn(ctx.report, "E_SOURCE_PARAM", "mode query needs a query", { name: "query", reason: "required" });
+    }
+    const shape = readQuery(query);
+    if (shape.form !== "construct" && shape.form !== "describe") {
+        failOn(ctx.report, "E_SOURCE_PARAM", "the query must be CONSTRUCT or DESCRIBE", {
+            name: "query",
+            reason: "form",
+        });
+    }
+    if (shape.ownLimit) {
+        return { at: () => query, paged: false };
+    }
+    return { at: (offset) => pagedQuery(query, shape, size, offset), paged: true };
+}
+/**
+ * Write nodes and edges into the sink, counting them on the report.
+ * @param graphed - the nodes and edges
+ * @param sink - where to write
+ * @param ctx - the context
+ */
+function write(graphed, sink, ctx) {
+    const { report } = ctx;
+    if (sink.edgeCount === 0) {
+        sink.setDirected(true);
+    }
+    for (const [id, attrs] of graphed.nodes) {
+        try {
+            sink.addNodeRecord(id, attrs);
+            report.counts.nodes++;
+        }
+        catch (err) {
+            report.recordError(err, { element: id });
+            report.counts.skippedNodes++;
+        }
+    }
+    for (const { source, target, ...attrs } of graphed.edges) {
+        try {
+            sink.addEdgeRecord(source, target, attrs, null);
+            report.counts.edges++;
+        }
+        catch (err) {
+            report.recordError(err, { element: `${source} -> ${target}` });
+            report.counts.skippedEdges++;
+        }
+    }
+}
+/**
+ * Order strings by UTF-16 code units, as `Array.prototype.sort` does with no compare function, so
+ * a content hash never depends on the locale.
+ * @param a - one string
+ * @param b - the other
+ * @returns negative, zero or positive
+ */
+function byCodeUnits(a, b) {
+    if (a === b) {
+        return 0;
+    }
+    return a < b ? -1 : 1;
+}
+/**
+ * The content hash of some triples, in any order.
+ * @param triples - the triples
+ * @returns the SHA-256, hex
+ */
+function hashOf(triples) {
+    return sha256Hex(triples.map(canonicalTriple).sort(byCodeUnits).join("\n"));
+}
+/**
+ * Load pages into the sink from the cursor's offset until an empty page or a cap.
+ * @param params - the params
+ * @param sink - where to write
+ * @param ctx - the context
+ * @returns the report
+ */
+async function load(params, sink, ctx) {
+    const plan = planOf(params, ctx);
+    const size = params.pageSize ?? DEFAULT_PAGE_SIZE;
+    const start = Number(ctx.cursor?.offset ?? 0);
+    const language = languageOf(params, ctx);
+    let offset = start;
+    let next = null;
+    let contentHash;
+    for (;;) {
+        const triples = await send(ctx, plan.at(offset));
+        if (offset === 0) {
+            contentHash = await hashOf(triples);
+        }
+        write(graphTriples(triples, language), sink, ctx);
+        const { counts } = ctx.report;
+        ctx.progress(counts.nodes + counts.edges, undefined, "items");
+        if (!plan.paged || triples.length === 0) {
+            next = null;
+            break;
+        }
+        offset += size;
+        next = { offset };
+        if (ctx.limits.reached()) {
+            break;
+        }
+    }
+    return ctx.finish({ next, ...(contentHash === undefined ? {} : { validators: { contentHash } }) });
+}
+/**
+ * Fetch the triples around some IRIs into the sink, hop by hop.
+ * @param request - the seeds, direction, depth, limit and predicate filter
+ * @param sink - where to write
+ * @param ctx - the context
+ * @returns the report
+ */
+async function expand(request, sink, ctx) {
+    const direction = request.direction ?? "both";
+    if (!["out", "in", "both"].includes(direction)) {
+        failOn(ctx.report, "E_SOURCE_PARAM", "direction must be out, in or both", {
+            name: "direction",
+            reason: "enum",
+        });
+    }
+    const depth = integer(request.depth ?? 1, "depth", MAX_DEPTH, ctx);
+    const limit = integer(request.limit ?? DEFAULT_EXPAND_LIMIT, "limit", Number.MAX_SAFE_INTEGER, ctx);
+    const language = languageOf(request.params, ctx);
+    const filter = { language, predicates: predicatesOf(request.params, ctx) };
+    const types = request.relationshipTypes === undefined ? null : new Set(request.relationshipTypes);
+    // a capped one-hop expansion resumes at its offset; deeper ones are read whole per hop
+    const offset = depth === 1 ? Number(ctx.cursor?.offset ?? 0) : 0;
+    const seen = new Set(request.ids.map(String));
+    let frontier = irisOf(request.ids, "ids", ctx);
+    let next = null;
+    const graphed = { nodes: new Map(), edges: [] };
+    for (let hop = 0; hop < depth && frontier.length > 0; hop++) {
+        const triples = await send(ctx, aroundQuery(frontier, direction, filter, limit, offset));
+        const before = graphed.edges.length;
+        graphTriples(triples, language, graphed);
+        if (types !== null) {
+            const kept = graphed.edges.slice(before).filter((e) => types.has(e.type) || types.has(e.predicate));
+            graphed.edges.splice(before, Infinity, ...kept);
+        }
+        if (depth === 1 && triples.length > 0) {
+            next = { offset: offset + limit };
+        }
+        const reached = graphed.edges.slice(before).flatMap((e) => [e.source, e.target]);
+        frontier = [...new Set(reached)]
+            .filter((id) => !seen.has(id))
+            .flatMap((id) => {
+            seen.add(id);
+            const term = iriTerm(id);
+            return term === null ? [] : [term];
+        });
+    }
+    write(graphed, sink, ctx);
+    return ctx.finish({ next });
+}
+/**
+ * The SPARQL source: CONSTRUCT or DESCRIBE queries against any SPARQL 1.1 endpoint, paged by
+ * `LIMIT` and `OFFSET`, expanded by `VALUES`, validated by a hash of the first page. Experimental.
+ * @category Network sources
+ */
+export const sparqlSource = defineSource({
+    id: SPARQL_SOURCE_ID,
+    descriptor: SPARQL_DESCRIPTOR,
+    import: load,
+    expand,
+    probe: async (params, ctx) => {
+        // the endpoint answers a one-solution query: it is up, it reads SPARQL, the credential works
+        await send(ctx, "CONSTRUCT { ?s ?p ?o } WHERE { ?s ?p ?o } LIMIT 1");
+        languageOf(params, ctx);
+        return { ok: true };
+    },
+    validate: async (params, seen, ctx) => {
+        const contentHash = await hashOf(await send(ctx, planOf(params, ctx).at(0)));
+        let status = "unverifiable";
+        if (seen.contentHash !== undefined) {
+            status = seen.contentHash === contentHash ? "current" : "changed";
+        }
+        return { status, via: "hash", validators: { contentHash } };
+    },
+});
+//# sourceMappingURL=index.js.map

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

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

package/dist/src/sources/sparql/ntriples.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Reading the N-Triples a CONSTRUCT or DESCRIBE answers, and turning triples into nodes and edges:
+ * an IRI or blank-node object is an edge from the subject, a literal is an attribute of the
+ * subject named by the predicate's local name.
+ */
+/** One RDF term. */
+export type Term = {
+    readonly kind: "iri";
+    readonly value: string;
+} | {
+    readonly kind: "bnode";
+    readonly value: string;
+} | {
+    readonly kind: "literal";
+    readonly value: string;
+    readonly lang: string;
+    readonly datatype: string;
+};
+/** One triple. */
+export interface Triple {
+    /** The subject: an IRI or a blank node. */
+    readonly s: Term;
+    /** The predicate IRI. */
+    readonly p: string;
+    /** The object. */
+    readonly o: Term;
+}
+/**
+ * Parse N-Triples.
+ * @param text - the document
+ * @returns the triples, or the 1-based number of the first line that is not a triple
+ */
+export declare function parseNTriples(text: string): {
+    triples: Triple[];
+    badLine: number | null;
+};
+/**
+ * The local name of an IRI: what follows its last `#`, else its last `/`, else its last `:`.
+ * @param iri - the IRI
+ * @returns the local name, or the whole IRI when nothing follows
+ */
+export declare function localName(iri: string): string;
+/** The nodes and edges of some triples. */
+export interface Graphed {
+    /** Each subject's literal attributes, by subject id; a predicate's first value wins. */
+    readonly nodes: Map<string, Record<string, string | number | boolean>>;
+    /** One edge per IRI or blank-node object. */
+    readonly edges: {
+        source: string;
+        target: string;
+        type: string;
+        predicate: string;
+    }[];
+}
+/**
+ * Turn triples into nodes and edges.
+ * @param triples - the triples
+ * @param language - the language filter, lowercase, or ""
+ * @param into - nodes and edges to add to
+ * @returns the nodes and edges
+ */
+export declare function graphTriples(triples: readonly Triple[], language: string, into?: Graphed): Graphed;
+/**
+ * One canonical line per triple, for the content hash.
+ * @param t - the triple
+ * @returns the line
+ */
+export declare function canonicalTriple(t: Triple): string;
+//# sourceMappingURL=ntriples.d.ts.map

package/dist/src/sources/sparql/ntriples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ntriples.d.ts","sourceRoot":"","sources":["../../../../src/sources/sparql/ntriples.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oBAAoB;AACpB,MAAM,MAAM,IAAI,GACV;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7G,kBAAkB;AAClB,MAAM,WAAW,MAAM;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC;IACjB,yBAAyB;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC;CACpB;AAoFD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CA0BzF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AA4BD,2CAA2C;AAC3C,MAAM,WAAW,OAAO;IACpB,wFAAwF;IACxF,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IACvE,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACzF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAmBlG;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGjD"}