@rdfc/sparql-ingest-processor-ts 2.1.1 → 2.1.3

package/README.md

@@ -46,6 +46,8 @@ npm install @rdfc/sparql-ingest-processor-ts
 <ingester> a rdfc:SPARQLIngest;
     rdfc:memberStream <in>;
     rdfc:ingestConfig [
+        rdfc:operationMode "Replication";
+        rdfc:memberBatchSize 500;
         rdfc:memberShape "http://ex.org/Shape";
         rdfc:changeSemantics [
             rdfc:changeTypePath "http://ex.org/changeType";
@@ -83,6 +85,8 @@ npm install @rdfc/sparql-ingest-processor-ts
 ---
 
 ### Parameters of `rdfc:IngestConfig`:
+- `rdfc:operationMode` (**string**, optional): Operation mode of the processor. Can be `Replication` or `Sync`. `Replication` mode uses the [SPARQL Graph Store Protocol](https://www.w3.org/TR/sparql11-http-rdf-update/) to ingest data directly into a triple store, which assumes that all received data is meant to be added. `Sync` mode uses the [SPARQL UPDATE specification](https://www.w3.org/TR/sparql11-update/) to ingest data via SPARQL queries, which allows for all CRUD operations.
+- `rdfc:memberBatchSize` (**integer**, optional): Number of input records to batch together for ingestion when running in `Replication` mode.
 - `rdfc:memberShape` (**string**, optional): SHACL shape used to guide query construction when payloads are incomplete.
 - `rdfc:changeSemantics` (**rdfc:ChangeSemantics**, optional): Configures mapping between change types (create/update/delete) and SPARQL operations.
 - `rdfc:targetNamedGraph` (**string**, optional): Force all operations into a specific named graph.
@@ -132,7 +136,6 @@ npm install @rdfc/sparql-ingest-processor-ts
 
 ## Notes
 
-- Delete operations can be handled differently depending on how complete the input record is.
+- Delete operations can be handled differently depending on how complete the input record is. A SHACL shape (`rdfc:memberShape`) can be provided to help identify deletion targets when payloads are incomplete.
 - Transactions can buffer multiple input records and commit them together using `rdfc:transactionConfig`.
-- A SHACL shape (`rdfc:memberShape`) can be provided to help identify deletion targets when payloads are incomplete.
 

package/lib/Utils.js

@@ -81,7 +81,11 @@ export async function doSPARQLRequest(query, config, logger) {
         const timeout = config.measurePerformance?.queryTimeout || 1800;
         if (query.length > 0 && typeof query[0] !== 'string') {
             const quads = query;
-            const writer = new N3Writer();
+            let hasQuads = config.targetNamedGraph !== undefined;
+            if (quads.some(q => !q.graph.equals(df.defaultGraph()))) {
+                hasQuads = true;
+            }
+            const writer = new N3Writer({ format: hasQuads ? "N-Quads" : "N-Triples" });
             const serialized = writer.quadsToString(quads);
             const url = new URL(config.graphStoreUrl);
             if (config.accessToken) {
@@ -92,7 +96,7 @@ export async function doSPARQLRequest(query, config, logger) {
             const res = await fetch(url.toString(), {
                 method: "POST",
                 headers: {
-                    'Content-Type': 'application/n-quads',
+                    'Content-Type': hasQuads ? 'application/n-quads' : 'application/n-triples',
                 },
                 body: serialized,
                 dispatcher: new Agent({

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rdfc/sparql-ingest-processor-ts",
-    "version": "2.1.1",
+    "version": "2.1.3",
     "description": "SPARQL Update function to be within RDF-Connect pipelines",
     "author": "Julián Rojas",
     "contributors": [
@@ -39,7 +39,7 @@
         "@rdfc/js-runner": "^3.0.2",
         "@rdfjs/types": "^2.0.1",
         "@types/n3": "^1.26.1",
-        "@types/node": "^25.2.1",
+        "@types/node": "^25.2.2",
         "@typescript-eslint/eslint-plugin": "^8.54.0",
         "@typescript-eslint/parser": "^8.54.0",
         "@vitest/coverage-v8": "^4.0.18",