n3.js-messages 0.1.4 → 0.2.1

package/lib/MessageWriter.js

@@ -16,6 +16,7 @@ var _formats = require("./formats.js");
 // (current graph, subject, predicate) leaks from one message into the next, and trailing
 // empty messages survive a round trip (a delimiter before the end of the input does not create a message).
 
+/** @extends {Writer<import('@rdfjs/types').BaseQuad>} */
 class LogWriter extends _n.Writer {
   // ### `addDelimiter` ends the current message
   addDelimiter() {
@@ -23,36 +24,59 @@ class LogWriter extends _n.Writer {
     this._write(this._lineMode ? 'MESSAGE\n' : '@message .\n');
   }
 }
+
+/** @typedef {import('./internal.js').Done} Done */
+/** @typedef {import('./internal.js').End} End */
+/** @typedef {import('../common.js').MessageWriterOptions} Options */
+/** @typedef {Pick<import('./internal.js').Output, 'write'> & Partial<Pick<import('./internal.js').Output, 'end'>>} Output */
 class MessageWriter {
   // `outputStream` is optional: without it, `end` returns the output as a string
+  /** @overload
+   * @param {Options} [options] */
+  /** @overload
+   * @param {Output | null} outputStream
+   * @param {Options} [options] */
+  /** @param {Output | Options | null} [outputStream]
+   * @param {Options} [options] */
   constructor(outputStream, options) {
-    if (outputStream && typeof outputStream.write !== 'function') options = outputStream, outputStream = null;
+    if (outputStream && typeof /** @type {Output} */outputStream.write !== 'function') options = /** @type {Options} */outputStream, outputStream = null;
     options = options || {};
     this._format = (0, _formats.resolveFormat)(options.format);
     this._options = options;
-    this._version = options.version === undefined ? '1.2-messages' : options.version;
+    this._version = options.version ?? this._format.version ?? '1.2-messages';
     if (!(0, _formats.isMessagesVersion)(this._version) || !(0, _formats.isSupportedVersion)((0, _formats.baseVersion)(this._version))) throw new TypeError(`Unsupported RDF Messages version: "${this._version}"`);
     this._output = '';
-    this._stream = outputStream;
+    this._stream = /** @type {Output | null | undefined} */outputStream;
     this._endStream = !outputStream || options.end !== false;
     this._pending = 0;
+
+    /** @type {Done[]} */
     this._waiting = [];
+
+    /** @type {Error | null} */
     this._error = null;
     this._started = false;
     this._ended = false;
     this._open = false;
     this._count = 0; // messages begun so far: the index of the next message
     this._declared = Object.assign({}, options.prefixes);
+
+    /** @type {Record<string, string>} */
     this._newPrefixes = {};
     // The N3.js writer writes to this sink, which it never ends
+    /** @type {Pick<Output, 'write'>} */
     this._sink = {
       write: (chunk, encoding, done) => this._write(chunk, done)
     };
+
+    /** @type {LogWriter | null} */
     this._writer = null;
   }
 
   // ### `addMessage` writes the quads of one message, followed by a delimiter.
   // The callback (or returned promise) completes once the output is flushed.
+  /** @param {import('@rdfjs/types').BaseQuad[]} quads
+   * @param {Done} [done] */
   addMessage(quads, done) {
     return this._complete(done, () => {
       if (this._open) throw new Error('A message is already open');
@@ -63,6 +87,7 @@ class MessageWriter {
   }
 
   // ### `beginMessage` opens a message. It is optional: the first `addQuad` opens one implicitly.
+  /** @param {Done} [done] */
   beginMessage(done) {
     return this._complete(done, () => {
       if (this._open) throw new Error('A message is already open');
@@ -73,6 +98,9 @@ class MessageWriter {
   // ### `addQuad` writes a quad into the open message right away (a message is opened if there is none).
   // With a `messageIndex` (0-based), a change of index ends the current message and writes the empty
   // messages in between, as rdf-writer-ts does; a lower index than the current one is an error.
+  /** @param {import('@rdfjs/types').BaseQuad} quad
+   * @param {number | Done} [messageIndex]
+   * @param {Done} [done] */
   addQuad(quad, messageIndex, done) {
     if (typeof messageIndex === 'function') done = messageIndex, messageIndex = undefined;
     return this._complete(done, () => {
@@ -82,6 +110,7 @@ class MessageWriter {
   }
 
   // ### `endMessage` ends the open message with a delimiter. Without an open message, it writes an empty one.
+  /** @param {Done} [done] */
   endMessage(done) {
     return this._complete(done, () => {
       if (!this._open) this._begin();
@@ -91,14 +120,24 @@ class MessageWriter {
 
   // ### `addPrefix` declares a prefix, which is written before the next message
   // and stays in effect for all messages after it
+  /** @param {string} prefix
+   * @param {string | import('@rdfjs/types').NamedNode} iri
+   * @param {Done} [done] */
   addPrefix(prefix, iri, done) {
     return this._complete(done, () => {
-      if (!this._format.lineMode && this._declared[prefix] !== (iri.value || iri)) this._newPrefixes[prefix] = iri.value || iri;
+      if (!this._format.lineMode && this._declared[prefix] !== (typeof iri === 'string' ? iri : iri.value)) this._newPrefixes[prefix] = typeof iri === 'string' ? iri : iri.value;
     });
   }
 
   // ### `end` ends the log and, unless disabled, the output stream.
   // The callback receives the output as a string if no output stream was given.
+  /** @overload
+   * @returns {Promise<string | void>} */
+  /** @overload
+   * @param {End} done
+   * @returns {void} */
+  /** @param {End} [done]
+   * @returns {Promise<string | void> | void} */
   end(done) {
     // Ending twice is harmless
     if (this._ended) return typeof done === 'function' ? done(null) : Promise.resolve();
@@ -111,40 +150,53 @@ class MessageWriter {
   // ## Private methods
 
   // Runs an action and reports completion with a callback or a promise
+  /** @param {Done | undefined} done
+   * @param {() => void} action
+   * @returns {Promise<void> | void} */
   _complete(done, action) {
     if (this._ended) this._error = this._error || new Error('Cannot write after end');else try {
       action();
     } catch (error) {
-      this._error = this._error || error;
+      this._error = this._error || (/** @type {Error} */error);
     }
     if (typeof done === 'function') return this._whenFlushed(done);
     return new Promise((resolve, reject) => this._whenFlushed(error => error ? reject(error) : resolve()));
   }
 
   // Ends the output once all queued writes were accepted
+  /** @param {End} callback */
   _finish(callback) {
     this._ended = true;
     this._whenFlushed(error => this._endOutput(error, callback));
   }
+
+  /** @param {Error | null | undefined} error
+   * @param {End} callback */
   _endOutput(error, callback) {
     if (error || !this._endStream) return callback(error);
     if (!this._stream) return callback(null, this._output);
     try {
-      this._stream.end(endError => callback(endError));
+      (/** @type {Required<Output>} */this._stream).end(endError => callback(endError));
     } catch (endError) {
-      callback(endError);
+      callback(/** @type {Error} */endError);
     }
   }
 
   // Calls back once all queued writes were accepted by the output
+  /** @param {Done} done */
   _whenFlushed(done) {
     if (this._pending === 0) this._settle(done);else this._waiting.push(done);
   }
+
+  /** @param {Done} done */
   _settle(done) {
     const error = this._error;
     this._error = null;
     done(error || null);
   }
+
+  /** @param {string} chunk
+   * @param {Done} [done] */
   _write(chunk, done) {
     if (!this._stream) {
       this._output += chunk;
@@ -154,11 +206,13 @@ class MessageWriter {
     try {
       this._stream.write(chunk, 'utf8', error => this._written(error, done));
     } catch (error) {
-      this._written(error, done);
+      this._written(/** @type {Error} */error, done);
     }
   }
 
   // Registers that the output accepted a write, and wakes up those waiting for the output
+  /** @param {Error | null | undefined} error
+   * @param {Done} [done] */
   _written(error, done) {
     this._pending--;
     this._error = this._error || error || null;
@@ -175,7 +229,7 @@ class MessageWriter {
       this._writer = new LogWriter(this._sink, {
         format: this._format.name,
         end: false,
-        version: this._version,
+        version: options.writeVersion === false ? undefined : this._version,
         baseIRI: options.baseIRI,
         writeBase: options.writeBase,
         prefixes: this._declared
@@ -186,25 +240,30 @@ class MessageWriter {
   // Opens a message: declares the prefixes that were added since the previous one
   _begin() {
     this._start();
-    const writer = this._writer;
+    const writer = /** @type {LogWriter} */this._writer;
     for (const prefix of Object.keys(this._newPrefixes)) {
-      writer.addPrefix(prefix, this._newPrefixes[prefix]);
-      this._declared[prefix] = this._newPrefixes[prefix];
+      const iri = /** @type {string} */this._newPrefixes[prefix];
+      writer.addPrefix(prefix, iri);
+      this._declared[prefix] = iri;
     }
     this._newPrefixes = {};
     this._open = true;
     this._count++;
   }
+
+  /** @param {import('@rdfjs/types').BaseQuad} quad */
   _add(quad) {
+    /** @type {Done} */
     const record = error => error && (this._error = this._error || error);
-    this._writer.addQuad(quad.subject, quad.predicate, quad.object, quad.graph, record);
+    (/** @type {LogWriter} */this._writer).addQuad(quad.subject, quad.predicate, quad.object, quad.graph, record);
   }
   _close() {
     this._open = false;
-    this._writer.addDelimiter();
+    (/** @type {LogWriter} */this._writer).addDelimiter();
   }
 
   // Makes message `index` the open message, writing empty messages for the gap
+  /** @param {number} index */
   _moveTo(index) {
     const current = this._count - 1;
     if (!Number.isInteger(index) || index < 0) throw new RangeError(`Invalid message index: ${index}`);
@@ -219,17 +278,25 @@ class MessageWriter {
   }
 }
 
+/** @param {Iterable<import('@rdfjs/types').BaseQuad[]>} messages
+ * @param {Options} [options]
+ * @returns {string} */
 // ### `writeMessages` synchronously serializes an array of messages to a string
 exports.default = MessageWriter;
 function writeMessages(messages, options) {
   const writer = new MessageWriter(options);
+
+  /** @type {Error[]} */
   const errors = [];
-  let output;
+  let output = '';
+
+  /** @param {Error | null | undefined} error */
   function collect(error) {
     if (error) errors.push(error);
   }
   for (const message of messages) writer.addMessage(message, collect);
-  writer.end((error, result) => (collect(error), output = result));
+  writer.end((error, result) => (collect(error), output = /** @type {string} */result));
   if (errors.length > 0) throw errors[0];
   return output;
-}
+}
+//# sourceMappingURL=MessageWriter.js.map

package/lib/MessageWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageWriter.js","names":["Writer","resolveFormat","isMessagesVersion","isSupportedVersion","baseVersion"],"sources":["../src/MessageWriter.js"],"sourcesContent":["// **MessageWriter** writes RDF Message Logs (Turtle, TriG, N-Triples and N-Quads).\n//\n// One N3.js writer writes the whole log: its `version` option announces the log,\n// and after each message, `_endStatement` finishes the pending statement (and graph block)\n// before a delimiter is written (`MESSAGE` in line formats, `@message .` in Turtle and TriG).\n// That way, consumers receive a message as soon as it is written, no serialization state\n// (current graph, subject, predicate) leaks from one message into the next, and trailing\n// empty messages survive a round trip (a delimiter before the end of the input does not create a message).\nimport { Writer } from 'n3';\nimport { resolveFormat, isMessagesVersion, baseVersion, isSupportedVersion } from './formats.js';\n\n/** @extends {Writer<import('@rdfjs/types').BaseQuad>} */\nclass LogWriter extends Writer {\n  // ### `addDelimiter` ends the current message\n  addDelimiter() {\n    this._endStatement();\n    this._write(this._lineMode ? 'MESSAGE\\n' : '@message .\\n');\n  }\n}\n\n/** @typedef {import('./internal.js').Done} Done */\n/** @typedef {import('./internal.js').End} End */\n/** @typedef {import('../common.js').MessageWriterOptions} Options */\n/** @typedef {Pick<import('./internal.js').Output, 'write'> & Partial<Pick<import('./internal.js').Output, 'end'>>} Output */\nexport default class MessageWriter {\n  // `outputStream` is optional: without it, `end` returns the output as a string\n  /** @overload\n   * @param {Options} [options] */\n  /** @overload\n   * @param {Output | null} outputStream\n   * @param {Options} [options] */\n  /** @param {Output | Options | null} [outputStream]\n   * @param {Options} [options] */\n  constructor(outputStream, options) {\n    if (outputStream && typeof /** @type {Output} */ (outputStream).write !== 'function')\n      options = /** @type {Options} */ (outputStream), outputStream = null;\n    options = options || {};\n    this._format = resolveFormat(options.format);\n    this._options = options;\n    this._version = options.version ?? this._format.version ?? '1.2-messages';\n    if (!isMessagesVersion(this._version) || !isSupportedVersion(baseVersion(this._version)))\n      throw new TypeError(`Unsupported RDF Messages version: \"${this._version}\"`);\n\n    this._output = '';\n    this._stream = /** @type {Output | null | undefined} */ (outputStream);\n    this._endStream = !outputStream || options.end !== false;\n    this._pending = 0;\n\n    /** @type {Done[]} */\n    this._waiting = [];\n\n    /** @type {Error | null} */\n    this._error = null;\n    this._started = false;\n    this._ended = false;\n    this._open = false;\n    this._count = 0; // messages begun so far: the index of the next message\n    this._declared = Object.assign({}, options.prefixes);\n\n    /** @type {Record<string, string>} */\n    this._newPrefixes = {};\n    // The N3.js writer writes to this sink, which it never ends\n    /** @type {Pick<Output, 'write'>} */\n    this._sink = { write: (chunk, encoding, done) => this._write(chunk, done) };\n\n    /** @type {LogWriter | null} */\n    this._writer = null;\n  }\n\n  // ### `addMessage` writes the quads of one message, followed by a delimiter.\n  // The callback (or returned promise) completes once the output is flushed.\n  /** @param {import('@rdfjs/types').BaseQuad[]} quads\n   * @param {Done} [done] */\n  addMessage(quads, done) {\n    return this._complete(done, () => {\n      if (this._open) throw new Error('A message is already open');\n      this._begin();\n      for (const quad of quads || []) this._add(quad);\n      this._close();\n    });\n  }\n\n  // ### `beginMessage` opens a message. It is optional: the first `addQuad` opens one implicitly.\n  /** @param {Done} [done] */\n  beginMessage(done) {\n    return this._complete(done, () => {\n      if (this._open) throw new Error('A message is already open');\n      this._begin();\n    });\n  }\n\n  // ### `addQuad` writes a quad into the open message right away (a message is opened if there is none).\n  // With a `messageIndex` (0-based), a change of index ends the current message and writes the empty\n  // messages in between, as rdf-writer-ts does; a lower index than the current one is an error.\n  /** @param {import('@rdfjs/types').BaseQuad} quad\n   * @param {number | Done} [messageIndex]\n   * @param {Done} [done] */\n  addQuad(quad, messageIndex, done) {\n    if (typeof messageIndex === 'function') done = messageIndex, messageIndex = undefined;\n    return this._complete(done, () => {\n      if (messageIndex !== undefined && messageIndex !== null) this._moveTo(messageIndex);\n      else if (!this._open) this._begin();\n      this._add(quad);\n    });\n  }\n\n  // ### `endMessage` ends the open message with a delimiter. Without an open message, it writes an empty one.\n  /** @param {Done} [done] */\n  endMessage(done) {\n    return this._complete(done, () => {\n      if (!this._open) this._begin();\n      this._close();\n    });\n  }\n\n  // ### `addPrefix` declares a prefix, which is written before the next message\n  // and stays in effect for all messages after it\n  /** @param {string} prefix\n   * @param {string | import('@rdfjs/types').NamedNode} iri\n   * @param {Done} [done] */\n  addPrefix(prefix, iri, done) {\n    return this._complete(done, () => {\n      if (!this._format.lineMode && this._declared[prefix] !== (typeof iri === 'string' ? iri : iri.value))\n        this._newPrefixes[prefix] = typeof iri === 'string' ? iri : iri.value;\n    });\n  }\n\n  // ### `end` ends the log and, unless disabled, the output stream.\n  // The callback receives the output as a string if no output stream was given.\n  /** @overload\n   * @returns {Promise<string | void>} */\n  /** @overload\n   * @param {End} done\n   * @returns {void} */\n  /** @param {End} [done]\n   * @returns {Promise<string | void> | void} */\n  end(done) {\n    // Ending twice is harmless\n    if (this._ended)\n      return typeof done === 'function' ? done(null) : Promise.resolve();\n    this._start();\n    if (this._open)\n      this._close();\n    if (typeof done === 'function')\n      return this._finish(done);\n    return new Promise((resolve, reject) => this._finish((error, result) => error ? reject(error) : resolve(result)));\n  }\n\n  // ## Private methods\n\n  // Runs an action and reports completion with a callback or a promise\n  /** @param {Done | undefined} done\n   * @param {() => void} action\n   * @returns {Promise<void> | void} */\n  _complete(done, action) {\n    if (this._ended)\n      this._error = this._error || new Error('Cannot write after end');\n    else\n      try {\n        action();\n      }\n      catch (error) {\n        this._error = this._error || /** @type {Error} */ (error);\n      }\n    if (typeof done === 'function')\n      return this._whenFlushed(done);\n    return new Promise((resolve, reject) => this._whenFlushed(error => error ? reject(error) : resolve()));\n  }\n\n  // Ends the output once all queued writes were accepted\n  /** @param {End} callback */\n  _finish(callback) {\n    this._ended = true;\n    this._whenFlushed(error => this._endOutput(error, callback));\n  }\n\n  /** @param {Error | null | undefined} error\n   * @param {End} callback */\n  _endOutput(error, callback) {\n    if (error || !this._endStream)\n      return callback(error);\n    if (!this._stream)\n      return callback(null, this._output);\n    try {\n      (/** @type {Required<Output>} */ (this._stream)).end(endError => callback(endError));\n    }\n    catch (endError) {\n      callback(/** @type {Error} */ (endError));\n    }\n  }\n\n  // Calls back once all queued writes were accepted by the output\n  /** @param {Done} done */\n  _whenFlushed(done) {\n    if (this._pending === 0)\n      this._settle(done);\n    else\n      this._waiting.push(done);\n  }\n\n  /** @param {Done} done */\n  _settle(done) {\n    const error = this._error;\n    this._error = null;\n    done(error || null);\n  }\n\n  /** @param {string} chunk\n   * @param {Done} [done] */\n  _write(chunk, done) {\n    if (!this._stream) {\n      this._output += chunk;\n      return done && done();\n    }\n    this._pending++;\n    try {\n      this._stream.write(chunk, 'utf8', error => this._written(error, done));\n    }\n    catch (error) {\n      this._written(/** @type {Error} */ (error), done);\n    }\n  }\n\n  // Registers that the output accepted a write, and wakes up those waiting for the output\n  /** @param {Error | null | undefined} error\n   * @param {Done} [done] */\n  _written(error, done) {\n    this._pending--;\n    this._error = this._error || error || null;\n    done && done(error);\n    if (this._pending === 0)\n      this._waiting.splice(0).forEach(callback => this._settle(callback));\n  }\n\n  // Announces the RDF Messages version, which makes parsers expect delimiters,\n  // and declares the base and prefixes, which stay in effect for all messages\n  _start() {\n    if (!this._started) {\n      this._started = true;\n      const options = this._options;\n      this._writer = new LogWriter(this._sink, {\n        format: this._format.name,\n        end: false,\n        version: options.writeVersion === false ? undefined : this._version,\n        baseIRI: options.baseIRI,\n        writeBase: options.writeBase,\n        prefixes: this._declared,\n      });\n    }\n  }\n\n  // Opens a message: declares the prefixes that were added since the previous one\n  _begin() {\n    this._start();\n    const writer = /** @type {LogWriter} */ (this._writer);\n    for (const prefix of Object.keys(this._newPrefixes)) {\n      const iri = /** @type {string} */ (this._newPrefixes[prefix]);\n      writer.addPrefix(prefix, iri);\n      this._declared[prefix] = iri;\n    }\n    this._newPrefixes = {};\n    this._open = true;\n    this._count++;\n  }\n\n  /** @param {import('@rdfjs/types').BaseQuad} quad */\n  _add(quad) {\n    /** @type {Done} */\n    const record = error => error && (this._error = this._error || error);\n    (/** @type {LogWriter} */ (this._writer)).addQuad(quad.subject, quad.predicate, quad.object, quad.graph, record);\n  }\n  _close() {\n    this._open = false;\n    (/** @type {LogWriter} */ (this._writer)).addDelimiter();\n  }\n\n  // Makes message `index` the open message, writing empty messages for the gap\n  /** @param {number} index */\n  _moveTo(index) {\n    const current = this._count - 1;\n    if (!Number.isInteger(index) || index < 0) throw new RangeError(`Invalid message index: ${index}`);\n    if (this._open && index === current) return;\n    if (index <= current) throw new RangeError(`Message index ${index} is lower than the current message index ${current}`);\n    if (this._open) this._close();\n    while (this._count < index) {\n      this._begin();\n      this._close();\n    }\n    this._begin();\n  }\n}\n\n/** @param {Iterable<import('@rdfjs/types').BaseQuad[]>} messages\n * @param {Options} [options]\n * @returns {string} */\n// ### `writeMessages` synchronously serializes an array of messages to a string\nexport function writeMessages(messages, options) {\n  const writer = new MessageWriter(options);\n\n  /** @type {Error[]} */\n  const errors = [];\n  let output = '';\n\n  /** @param {Error | null | undefined} error */\n  function collect(error) {\n    if (error)\n      errors.push(error);\n  }\n  for (const message of messages)\n    writer.addMessage(message, collect);\n  writer.end((error, result) => (collect(error), output = /** @type {string} */ (result)));\n  if (errors.length > 0)\n    throw errors[0];\n  return output;\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/formats.js

@@ -9,6 +9,7 @@ exports.isSupportedVersion = isSupportedVersion;
 exports.resolveFormat = resolveFormat;
 // **formats** describes the RDF syntaxes that support RDF Messages.
 
+/** @type {Record<string, { name: string; lineMode: boolean }>} */
 const FORMATS = {
   turtle: {
     name: 'Turtle',
@@ -32,24 +33,41 @@ const FORMATS = {
 const BASE_VERSIONS = ['1.2', '1.2-basic', '1.1'];
 
 // ### `resolveFormat` maps a format name or media type to a supported syntax
+/** @returns {{ name: string; lineMode: boolean; version?: string }} */
 function resolveFormat(format = 'TriG') {
-  const key = String(format).toLowerCase().split(';')[0].trim().replace(/^(?:text|application)\//, '').replace(/^x-/, '').replace(/[-_ ]/g, '');
+  const key = String(format).toLowerCase().replace(/;[\s\S]*$/, '').trim().replace(/^(?:text|application)\//, '').replace(/^x-/, '').replace(/[-_ ]/g, '');
   const resolved = FORMATS[key];
   if (!resolved) throw new TypeError(`Unsupported RDF Messages format: "${format}". ` + 'Supported formats are Turtle, TriG, N-Triples and N-Quads.');
-  return resolved;
+  let version;
+  // Consume quoted values whole, so a semicolon inside another parameter cannot
+  // accidentally introduce a version parameter. Parameter names are case-insensitive.
+  for (const parameter of String(format).matchAll(/;\s*([^;=\s]+)\s*=\s*("(?:[^"\\]|\\.)*"|[^;]*)\s*(?=;|$)/g)) {
+    if (/** @type {string} */parameter[1].toLowerCase() === 'version') {
+      if (version !== undefined) throw new TypeError('Duplicate RDF version parameter.');
+      version = /** @type {string} */parameter[2].trim().replace(/^"(.*)"$/, '$1').replace(/\\(.)/g, '$1');
+    }
+  }
+  return version === undefined ? resolved : {
+    ...resolved,
+    version
+  };
 }
 
+/** @param {unknown} version */
 // ### `isMessagesVersion` checks whether a version label announces RDF Messages
 function isMessagesVersion(version) {
   return typeof version === 'string' && version.endsWith('-messages');
 }
 
+/** @param {string} version */
 // ### `baseVersion` strips the `-messages` suffix of a version label
 function baseVersion(version) {
   return isMessagesVersion(version) ? version.slice(0, -'-messages'.length) : version;
 }
 
+/** @param {string} version */
 // ### `isSupportedVersion` checks whether a (base) version label is supported
 function isSupportedVersion(version, supported = BASE_VERSIONS) {
   return supported.includes(version);
-}
+}
+//# sourceMappingURL=formats.js.map

package/lib/formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.js","names":[],"sources":["../src/formats.js"],"sourcesContent":["// **formats** describes the RDF syntaxes that support RDF Messages.\n\n/** @type {Record<string, { name: string; lineMode: boolean }>} */\nconst FORMATS = {\n  turtle: { name: 'Turtle', lineMode: false },\n  trig: { name: 'TriG', lineMode: false },\n  ntriples: { name: 'N-Triples', lineMode: true },\n  nquads: { name: 'N-Quads', lineMode: true },\n};\n\n// The version labels of RDF 1.2 syntaxes, as accepted by N3.js\nconst BASE_VERSIONS = ['1.2', '1.2-basic', '1.1'];\n\n// ### `resolveFormat` maps a format name or media type to a supported syntax\n/** @returns {{ name: string; lineMode: boolean; version?: string }} */\nexport function resolveFormat(format = 'TriG') {\n  const key = String(format).toLowerCase().replace(/;[\\s\\S]*$/, '').trim()\n    .replace(/^(?:text|application)\\//, '')\n    .replace(/^x-/, '')\n    .replace(/[-_ ]/g, '');\n  const resolved = FORMATS[key];\n  if (!resolved)\n    throw new TypeError(`Unsupported RDF Messages format: \"${format}\". ` +\n                        'Supported formats are Turtle, TriG, N-Triples and N-Quads.');\n  let version;\n  // Consume quoted values whole, so a semicolon inside another parameter cannot\n  // accidentally introduce a version parameter. Parameter names are case-insensitive.\n  for (const parameter of String(format).matchAll(/;\\s*([^;=\\s]+)\\s*=\\s*(\"(?:[^\"\\\\]|\\\\.)*\"|[^;]*)\\s*(?=;|$)/g)) {\n    if (/** @type {string} */ (parameter[1]).toLowerCase() === 'version') {\n      if (version !== undefined)\n        throw new TypeError('Duplicate RDF version parameter.');\n      version = /** @type {string} */ (parameter[2]).trim().replace(/^\"(.*)\"$/, '$1').replace(/\\\\(.)/g, '$1');\n    }\n  }\n  return version === undefined ? resolved : { ...resolved, version };\n}\n\n/** @param {unknown} version */\n// ### `isMessagesVersion` checks whether a version label announces RDF Messages\nexport function isMessagesVersion(version) {\n  return typeof version === 'string' && version.endsWith('-messages');\n}\n\n/** @param {string} version */\n// ### `baseVersion` strips the `-messages` suffix of a version label\nexport function baseVersion(version) {\n  return isMessagesVersion(version) ? version.slice(0, -'-messages'.length) : version;\n}\n\n/** @param {string} version */\n// ### `isSupportedVersion` checks whether a (base) version label is supported\nexport function isSupportedVersion(version, supported = BASE_VERSIONS) {\n  return supported.includes(version);\n}\n"],"mappings":";;;;;;;;;AAAA;;AAEA;AACA,MAAM,OAAO,GAAG;EACd,MAAM,EAAE;IAAE,IAAI,EAAE,QAAQ;IAAE,QAAQ,EAAE;EAAM,CAAC;EAC3C,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM;IAAE,QAAQ,EAAE;EAAM,CAAC;EACvC,QAAQ,EAAE;IAAE,IAAI,EAAE,WAAW;IAAE,QAAQ,EAAE;EAAK,CAAC;EAC/C,MAAM,EAAE;IAAE,IAAI,EAAE,SAAS;IAAE,QAAQ,EAAE;EAAK;AAC5C,CAAC;;AAED;AACA,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC;;AAEjD;AACA;AACO,SAAS,aAAa,CAAC,MAAM,GAAG,MAAM,EAAE;EAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CACrE,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CACtC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAClB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;EACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;EAC7B,IAAI,CAAC,QAAQ,EACX,MAAM,IAAI,SAAS,CAAC,qCAAqC,MAAM,KAAK,GAChD,4DAA4D,CAAC;EACnF,IAAI,OAAO;EACX;EACA;EACA,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,2DAA2D,CAAC,EAAE;IAC5G,IAAI,qBAAuB,SAAS,CAAC,CAAC,CAAC,CAAE,WAAW,CAAC,CAAC,KAAK,SAAS,EAAE;MACpE,IAAI,OAAO,KAAK,SAAS,EACvB,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC;MACzD,OAAO,GAAG,qBAAuB,SAAS,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;IACzG;EACF;EACA,OAAO,OAAO,KAAK,SAAS,GAAG,QAAQ,GAAG;IAAE,GAAG,QAAQ;IAAE;EAAQ,CAAC;AACpE;;AAEA;AACA;AACO,SAAS,iBAAiB,CAAC,OAAO,EAAE;EACzC,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;AACrE;;AAEA;AACA;AACO,SAAS,WAAW,CAAC,OAAO,EAAE;EACnC,OAAO,iBAAiB,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO;AACrF;;AAEA;AACA;AACO,SAAS,kBAAkB,CAAC,OAAO,EAAE,SAAS,GAAG,aAAa,EAAE;EACrE,OAAO,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;AACpC","ignoreList":[]}

package/lib/index.js

@@ -45,4 +45,5 @@ var _MessageWriter = _interopRequireWildcard(require("./MessageWriter.js"));
 var _MessageStreamWriter = _interopRequireDefault(require("./MessageStreamWriter.js"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 var cache;
-function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
+function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.js"],"sourcesContent":["export { default as MessageParser, parseMessages } from './MessageParser.js';\nexport { default as MessageStreamParser } from './MessageStreamParser.js';\nexport { default as MessageWriter, writeMessages } from './MessageWriter.js';\nexport { default as MessageStreamWriter } from './MessageStreamWriter.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AACA;AACA;AACA;AAA0E;AAAA;AAAA","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n3.js-messages",
-  "version": "0.1.4",
+  "version": "0.2.1",
   "description": "RDF Messages (message-delimited Turtle, TriG, N-Triples and N-Quads) for N3.js: message-aware parser, streaming parser and writer.",
   "author": "Pieter Colpaert",
   "license": "MIT",
@@ -21,20 +21,35 @@
   "types": "./index.d.ts",
   "exports": {
     ".": {
+      "browser": {
+        "types": "./browser.d.ts",
+        "default": "./browser/index.js"
+      },
       "types": "./index.d.ts",
       "import": "./src/index.js",
       "require": "./lib/index.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./browser": {
+      "types": "./browser.d.ts",
+      "import": "./browser/index.js",
+      "default": "./browser/index.js"
+    },
+    "./browser/global": "./browser/index.global.js"
   },
-  "sideEffects": false,
+  "sideEffects": [
+    "./browser/index.global.js"
+  ],
   "engines": {
     "node": ">=18"
   },
   "files": [
     "src",
     "lib",
-    "index.d.ts"
+    "index.d.ts",
+    "browser",
+    "browser.d.ts",
+    "common.d.ts"
   ],
   "peerDependencies": {
     "n3": ">=2.13.7 <3"
@@ -48,35 +63,47 @@
   },
   "homepage": "https://github.com/pietercolpaert/n3.js-messages#readme",
   "scripts": {
-    "build": "babel src -d lib --copy-files --no-copy-ignored && node scripts/write-lib-package.js",
+    "build": "node scripts/build.js",
     "prepack": "npm run build",
     "test": "jest",
     "coverage": "jest --coverage",
-    "lint": "eslint src test spec perf scripts",
+    "lint": "eslint . && knip",
     "test:spec": "node spec/runner.js",
     "test:spec:earl": "node spec/runner.js --earl > spec/earl-report.ttl",
     "test:types": "tsc -p test/types/tsconfig.json",
     "test:package": "node scripts/test-package.js",
     "perf": "node perf/run.js",
     "perf:compare": "node perf/compare.js",
-    "spec:update": "node scripts/update-spec.js"
+    "spec:update": "node scripts/update-spec.js",
+    "typecheck": "tsc -p tsconfig.json",
+    "check": "npm run lint && npm run typecheck && npm run test:types && npm run build && npm test -- --runInBand && npm run test:spec",
+    "ci": "npm run check && npm run test:package && npm run test:browser && npm run perf:regression",
+    "test:browser": "node scripts/test-browser.js",
+    "hooks:install": "node scripts/install-hooks.js",
+    "perf:regression": "node perf/regression.js",
+    "test:n3-extract": "node scripts/extract-n3-parser-tests.cjs"
   },
   "devDependencies": {
     "@babel/cli": "^8.0.6",
-    "@babel/core": "^8.0.7",
+    "@babel/core": "^8.0.9",
     "@babel/preset-env": "^8.0.7",
-    "@types/n3": "^1.26.4",
-    "@types/node": "^26.6.4",
+    "@types/n3": "^1.26.5",
+    "@types/node": "^26.6.5",
     "babel-jest": "^30.5.2",
-    "eslint": "^10.12.0",
+    "esbuild": "^0.28.2",
+    "eslint": "^10.13.0",
     "eslint-plugin-import-x": "^4.17.1",
-    "eslint-plugin-jest": "^29.16.6",
+    "eslint-plugin-jest": "^29.17.0",
+    "events": "^3.3.0",
     "globals": "^17.13.0",
     "jest": "^30.5.2",
-    "n3": "^2.13.8",
+    "knip": "^6.43.0",
+    "n3": "^2.13.12",
+    "playwright": "^1.64.1",
     "rdf-isomorphic": "^2.0.1",
     "rdf-parser-ts": "^0.4.0",
     "rdf-writer-ts": "^0.2.1",
+    "string_decoder": "^1.3.0",
     "typescript": "^7.0.2"
   },
   "jest": {
@@ -103,5 +130,6 @@
   },
   "dependencies": {
     "@rdfjs/types": "^2.0.1"
-  }
+  },
+  "browser": "./browser/index.js"
 }

package/src/MessageParser.js

@@ -2,13 +2,18 @@
 import { StringDecoder } from 'string_decoder';
 import MessageParserCore from './MessageParserCore.js';
 
+/** @template {import('@rdfjs/types').BaseQuad} [Q=import('@rdfjs/types').Quad] */
 export default class MessageParser {
+  /** @param {import('../common.js').MessageParserOptions<Q>} [options] */
   constructor(options) {
+    /** @type {import('../common.js').MessageParserOptions<Q>} */
     this._options = options || {};
     // Fail early on unsupported options
-    this._createCore({});
+    // Construction only validates options; this core never receives input.
+    this._createCore(/** @type {import('./internal.js').ParserSink<Q>} */ ({}));
   }
 
+  /** @param {import('./internal.js').ParserSink<Q>} sink */
   _createCore(sink) {
     return new MessageParserCore(this._options, sink);
   }
@@ -21,23 +26,45 @@ export default class MessageParser {
   // callbacks `onMessage(error, message, prefixes)`, `onQuad(error, quad, messageIndex)`,
   // `onPrefix(prefix, term)` and `onVersion(label)`, messages are reported as soon
   // as they are complete. The final call has `null` as message.
+  /**
+   * @overload
+   * @param {string} input
+   * @returns {Q[][]}
+   */
+  /**
+   * @overload
+   * @param {string | NodeJS.ReadableStream} input
+   * @param {import('../common.js').MessageCallback<Q> | import('../common.js').MessageParseCallbacks<Q>} [callbacks]
+   * @returns {void}
+   */
+  /**
+   * @param {string | NodeJS.ReadableStream} input
+   * @param {import('../common.js').MessageCallback<Q> | import('../common.js').MessageParseCallbacks<Q>} [callbacks]
+   * @returns {Q[][] | undefined}
+   */
   parse(input, callbacks) {
     if (typeof callbacks === 'function')
       callbacks = { onMessage: callbacks };
+
+    /** @type {Q[][] | null} */
     const messages = callbacks ? null : [];
+
+    /** @type {Error | null} */
     let error = null;
     callbacks = callbacks || {};
+
+    /** @type {import('./internal.js').ParserSink<Q>} */
     const sink = {
       message: (quads, index) => callbacks.onMessage ? callbacks.onMessage(null, quads, undefined, index) : messages && messages.push(quads),
       end: prefixes => callbacks.onMessage && callbacks.onMessage(null, null, prefixes),
       error: e => {
         error = e;
-        callbacks.onMessage && callbacks.onMessage(e);
+        callbacks.onMessage && callbacks.onMessage(e, null);
         callbacks.onQuad && callbacks.onQuad(e);
       },
     };
     if (callbacks.onQuad)
-      sink.quad = (quad, index) => callbacks.onQuad(null, quad, index);
+      sink.quad = (quad, index) => callbacks.onQuad?.(null, quad, index);
     if (callbacks.onPrefix)
       sink.prefix = callbacks.onPrefix;
     if (callbacks.onVersion)
@@ -65,6 +92,11 @@ export default class MessageParser {
   }
 }
 
+/**
+ * @template {import('@rdfjs/types').BaseQuad} [Q=import('@rdfjs/types').Quad]
+ * @param {string} input
+ * @param {import('../common.js').MessageParserOptions<Q>} [options]
+ */
 // ### `parseMessages` synchronously parses a string into an array of messages
 export function parseMessages(input, options) {
   return new MessageParser(options).parse(input);