@lde/fastify-rdf 0.2.11 → 0.3.0

package/README.md

@@ -43,8 +43,8 @@ app.get('/resource', async (request, reply) => {
     quad(
       namedNode('http://example.org/subject'),
       namedNode('http://example.org/predicate'),
-      literal('object')
-    )
+      literal('object'),
+    ),
   );
   return reply.sendRdf(store);
 });
@@ -66,13 +66,32 @@ app.get('/resource', async () => {
     quad(
       namedNode('http://example.org/subject'),
       namedNode('http://example.org/predicate'),
-      literal('object')
-    )
+      literal('object'),
+    ),
   );
   return store;
 });
 ```
 
+### Parsing RDF Request Bodies
+
+The plugin registers content type parsers for all RDF formats supported by [rdf-parse](https://github.com/rubensworks/rdf-parse.js). Individual routes opt in via `config: { parseRdf: true }` — the body is then parsed into a `DatasetCore`:
+
+```typescript
+app.post('/data', { config: { parseRdf: true } }, async (request) => {
+  const dataset = request.body as DatasetCore; // N3 Store
+  console.log(`Received ${dataset.size} quads`);
+});
+```
+
+To parse RDF bodies on **all** routes, enable `parseRdf` at the plugin level:
+
+```typescript
+await app.register(fastifyRdf, { parseRdf: true });
+```
+
+Routes without per-route or plugin-level `parseRdf` get JSON fallback for `application/ld+json` (parsed as plain JSON) and 415 Unsupported Media Type for other RDF content types.
+
 ### Custom Default Content Type
 
 By default, the plugin uses `text/turtle` when no `Accept` header is provided. You can change this:
@@ -126,6 +145,12 @@ interface FastifyRdfOptions {
    * @default false
    */
   overrideSend?: boolean;
+
+  /**
+   * Parse RDF request bodies into a DatasetCore on all routes.
+   * @default false
+   */
+  parseRdf?: boolean;
 }
 ```
 

package/dist/plugin.d.ts

@@ -8,6 +8,7 @@ import { type FastifyRdfOptions } from './types.js';
  * - Optionally overrides reply.send() to serialize all responses as RDF
  * - Handles content negotiation via Accept headers
  * - Defaults to Turtle when no Accept header is provided
+ * - Registers content type parsers for RDF request bodies
  */
 declare function fastifyRdfPlugin(server: FastifyInstance, options: FastifyRdfOptions): Promise<void>;
 /**

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAM7E,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,YAAY,CAAC;AA+CpB;;;;;;;;GAQG;AACH,iBAAe,gBAAgB,CAC7B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,yBAGrB,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAQ7E,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,YAAY,CAAC;AA4HpB;;;;;;;;;GASG;AACH,iBAAe,gBAAgB,CAC7B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA4Df;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,yBAGrB,CAAC"}

package/dist/plugin.js

@@ -1,6 +1,8 @@
 import { fastifyPlugin } from 'fastify-plugin';
 import { fastifyAccepts } from '@fastify/accepts';
 import { rdfSerializer } from 'rdf-serialize';
+import { rdfParser } from 'rdf-parse';
+import { Store } from 'n3';
 import { Readable } from 'node:stream';
 import { DEFAULT_CONTENT_TYPE, } from './types.js';
 /**
@@ -35,6 +37,69 @@ function negotiateContentType(request, supportedTypes, defaultType) {
     }
     return (request.accepts().type(supportedTypes) || defaultType);
 }
+/**
+ * Collect quads from a readable stream into an N3 Store.
+ */
+async function streamToDataset(stream) {
+    const store = new Store();
+    for await (const quad of stream) {
+        store.add(quad);
+    }
+    return store;
+}
+/**
+ * Register Fastify content type parsers for all RDF formats.
+ *
+ * When `parseAll` is true (from the plugin-level `parseRdf` option), every
+ * route gets RDF body parsing. Otherwise, routes opt in individually via
+ * `config: { parseRdf: true }`. Non-opted-in routes get JSON fallback for
+ * `application/ld+json` and 415 for other RDF types.
+ */
+async function registerRdfParsers(server, parseAll) {
+    const contentTypes = (await rdfParser.getContentTypes()).filter((type) => type !== 'application/json');
+    server.addContentTypeParser(contentTypes, function (_request, payload, done) {
+        // Collect the raw body; the preParsing hook is not needed because
+        // Fastify passes the raw payload stream here.
+        const chunks = [];
+        payload.on('data', (chunk) => chunks.push(chunk));
+        payload.on('end', () => done(null, Buffer.concat(chunks)));
+        payload.on('error', done);
+    });
+    server.addHook('preHandler', async (request) => {
+        // Only act on requests that matched an RDF content type parser.
+        if (!request.body ||
+            !Buffer.isBuffer(request.body) ||
+            !request.headers['content-type']) {
+            return;
+        }
+        const contentType = request.headers['content-type'].split(';')[0].trim();
+        if (!contentTypes.includes(contentType)) {
+            return;
+        }
+        if (parseAll || request.routeOptions.config.parseRdf) {
+            try {
+                const bodyStream = Readable.from(request.body);
+                const quadStream = rdfParser.parse(bodyStream, { contentType });
+                request.body = await streamToDataset(quadStream);
+            }
+            catch (cause) {
+                const error = new Error('Invalid RDF body', {
+                    cause,
+                });
+                error.statusCode = 400;
+                throw error;
+            }
+        }
+        else if (contentType === 'application/ld+json') {
+            request.body = JSON.parse(request.body.toString('utf8'));
+        }
+        else {
+            const error = new Error(`Unsupported Media Type: ${contentType}`);
+            error.statusCode = 415;
+            throw error;
+        }
+    });
+}
 /**
  * Fastify plugin for serving RDF data with content negotiation.
  *
@@ -43,6 +108,7 @@ function negotiateContentType(request, supportedTypes, defaultType) {
  * - Optionally overrides reply.send() to serialize all responses as RDF
  * - Handles content negotiation via Accept headers
  * - Defaults to Turtle when no Accept header is provided
+ * - Registers content type parsers for RDF request bodies
  */
 async function fastifyRdfPlugin(server, options) {
     const defaultContentType = options.defaultContentType ?? DEFAULT_CONTENT_TYPE;
@@ -78,6 +144,7 @@ async function fastifyRdfPlugin(server, options) {
             return this.send(serialized);
         });
     }
+    await registerRdfParsers(server, options.parseRdf ?? false);
 }
 /**
  * Fastify plugin for serving RDF data with content negotiation.

package/dist/types.d.ts

@@ -19,6 +19,12 @@ export interface FastifyRdfOptions {
      * @default false
      */
     overrideSend?: boolean;
+    /**
+     * Parse RDF request bodies into a DatasetCore on all routes.
+     * When not set, individual routes can opt in via `config: { parseRdf: true }`.
+     * @default false
+     */
+    parseRdf?: boolean;
 }
 /**
  * RDF data that can be serialized: either a DatasetCore or an RDF.js Stream of quads.
@@ -33,5 +39,8 @@ declare module 'fastify' {
          */
         sendRdf(data: RdfData): RdfData | Promise<FastifyReply>;
     }
+    interface FastifyContextConfig {
+        parseRdf?: boolean;
+    }
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;AAE3C,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,YAAY;QACpB;;;;WAIG;QACH,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;KACzD;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;AAE3C,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,YAAY;QACpB;;;;WAIG;QACH,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;KACzD;IAED,UAAU,oBAAoB;QAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB;CACF"}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@lde/fastify-rdf",
-  "version": "0.2.11",
+  "version": "0.3.0",
   "description": "Fastify plugin for serving RDF data with content negotiation",
   "repository": {
-    "url": "https://github.com/ldengine/lde",
+    "url": "git+https://github.com/ldengine/lde.git",
     "directory": "packages/fastify-rdf"
   },
   "type": "module",
@@ -26,13 +26,14 @@
   "dependencies": {
     "@fastify/accepts": "^5.0.0",
     "fastify-plugin": "^5.0.0",
+    "n3": "^2.0.1",
+    "rdf-parse": "^5.0.0",
     "rdf-serialize": "^5.1.0",
     "tslib": "^2.3.0"
   },
   "devDependencies": {
     "@rdfjs/types": "^2.0.0",
-    "fastify": "^5.7.4",
-    "n3": "^1.17.0"
+    "fastify": "^5.7.4"
   },
   "peerDependencies": {
     "fastify": "^5.7.4"