@d1g1tal/transportr 1.0.0 → 1.2.0

package/dist/transportr.js

@@ -54,6 +54,10 @@ var Transportr = (() => {
   var _type = (object) => object?.constructor ?? object?.prototype?.constructor ?? globalThis[Object.prototype.toString.call(object).slice(8, -1)] ?? object;
   var object_type_default = _type;
 
+  // node_modules/@d1g1tal/chrysalis/src/esm/object-is-empty.js
+  var _objectIsEmpty = (object) => !!object && Object.keys(object).length === 0 && object.constructor === Object;
+  var object_is_empty_default = _objectIsEmpty;
+
   // node_modules/@d1g1tal/chrysalis/src/esm/object-merge.js
   var _objectMerge = (...objects) => {
     const target = {};
@@ -78,10 +82,6 @@ var Transportr = (() => {
   };
   var object_merge_default = _objectMerge;
 
-  // node_modules/@d1g1tal/chrysalis/src/esm/object-is-empty.js
-  var _objectIsEmpty = (object) => !!object && Object.keys(object).length === 0 && object.constructor === Object;
-  var object_is_empty_default = _objectIsEmpty;
-
   // node_modules/@d1g1tal/collections/src/set-multi-map.js
   var SetMultiMap = class extends Map {
     /**
@@ -101,34 +101,33 @@ var Transportr = (() => {
   };
 
   // node_modules/@d1g1tal/media-type/src/utils.js
-  var removeLeadingAndTrailingHTTPWhitespace = (string) => string.replace(/^[ \t\n\r]+/u, "").replace(/[ \t\n\r]+$/u, "");
-  var removeTrailingHTTPWhitespace = (string) => string.replace(/[ \t\n\r]+$/u, "");
-  var isHTTPWhitespaceChar = (char) => char === " " || char === "	" || char === "\n" || char === "\r";
-  var solelyContainsHTTPTokenCodePoints = (string) => /^[-!#$%&'*+.^_`|~A-Za-z0-9]*$/u.test(string);
-  var solelyContainsHTTPQuotedStringTokenCodePoints = (string) => /^[\t\u0020-\u007E\u0080-\u00FF]*$/u.test(string);
-  var asciiLowercase = (string) => string.replace(/[A-Z]/ug, (l) => l.toLowerCase());
+  var whitespaceCharacters = [" ", "	", "\n", "\r"];
+  var leadingWhitespace = /^[ \t\n\r]+/u;
+  var trailingWhitespace = /[ \t\n\r]+$/u;
+  var httpTokenCodePoints = /^[-!#$%&'*+.^_`|~A-Za-z0-9]*$/u;
+  var httpQuotedTokenCodePoints = /^[\t\u0020-\u007E\u0080-\u00FF]*$/u;
+  var removeLeadingAndTrailingHTTPWhitespace = (string) => string.replace(leadingWhitespace, "").replace(trailingWhitespace, "");
+  var removeTrailingHTTPWhitespace = (string) => string.replace(trailingWhitespace, "");
+  var isHTTPWhitespaceChar = (char) => whitespaceCharacters.includes(char);
+  var solelyContainsHTTPTokenCodePoints = (string) => httpTokenCodePoints.test(string);
+  var solelyContainsHTTPQuotedStringTokenCodePoints = (string) => httpQuotedTokenCodePoints.test(string);
+  var asciiLowercase = (string) => {
+    let result = "";
+    for (const [char, charCode = char.charCodeAt(0)] of string) {
+      result += charCode >= 65 && charCode <= 90 ? String.fromCharCode(charCode + 32) : char;
+    }
+    return result;
+  };
   var collectAnHTTPQuotedString = (input, position) => {
     let value = "";
-    position++;
-    while (true) {
-      while (position < input.length && input[position] !== '"' && input[position] !== "\\") {
-        value += input[position];
-        ++position;
-      }
-      if (position >= input.length) {
+    for (let length = input.length, char; ++position < length; ) {
+      char = input[position];
+      if (char == "\\") {
+        value += ++position < length ? input[position] : char;
+      } else if (char == '"') {
         break;
-      }
-      const quoteOrBackslash = input[position];
-      ++position;
-      if (quoteOrBackslash === "\\") {
-        if (position >= input.length) {
-          value += "\\";
-          break;
-        }
-        value += input[position];
-        ++position;
       } else {
-        break;
+        value += char;
       }
     }
     return [value, position];
@@ -136,13 +135,15 @@ var Transportr = (() => {
 
   // node_modules/@d1g1tal/media-type/src/media-type-parameters.js
   var MediaTypeParameters = class {
+    /** @type {Map<string, string>} */
+    #map;
     /**
      * Create a new MediaTypeParameters instance.
      *
-     * @param {Map.<string, string>} map The map of parameters for a media type.
+     * @param {Array<Array<string>>} entries An array of [name, value] tuples.
      */
-    constructor(map) {
-      this._map = map;
+    constructor(entries) {
+      this.#map = new Map(entries);
     }
     /**
      * Gets the number of media type parameters.
@@ -150,7 +151,7 @@ var Transportr = (() => {
      * @returns {number} The number of media type parameters
      */
     get size() {
-      return this._map.size;
+      return this.#map.size;
     }
     /**
      * Gets the media type parameter value for the supplied name.
@@ -159,7 +160,7 @@ var Transportr = (() => {
      * @returns {string} The media type parameter value.
      */
     get(name) {
-      return this._map.get(asciiLowercase(String(name)));
+      return this.#map.get(asciiLowercase(String(name)));
     }
     /**
      * Indicates whether the media type parameter with the specified name exists or not.
@@ -168,7 +169,7 @@ var Transportr = (() => {
      * @returns {boolean} true if the media type parameter exists, false otherwise.
      */
     has(name) {
-      return this._map.has(asciiLowercase(String(name)));
+      return this.#map.has(asciiLowercase(String(name)));
     }
     /**
      * Adds a new media type parameter using the specified name and value to the MediaTypeParameters.
@@ -187,14 +188,14 @@ var Transportr = (() => {
       if (!solelyContainsHTTPQuotedStringTokenCodePoints(value)) {
         throw new Error(`Invalid media type parameter value "${value}": only HTTP quoted-string token code points are valid.`);
       }
-      this._map.set(name, value);
+      this.#map.set(name, value);
       return this;
     }
     /**
      * Clears all the media type parameters.
      */
     clear() {
-      this._map.clear();
+      this.#map.clear();
     }
     /**
      * Removes the media type parameter using the specified name.
@@ -204,7 +205,7 @@ var Transportr = (() => {
      */
     delete(name) {
       name = asciiLowercase(String(name));
-      return this._map.delete(name);
+      return this.#map.delete(name);
     }
     /**
      * Executes a provided function once per each name/value pair in the MediaTypeParameters, in insertion order.
@@ -213,7 +214,7 @@ var Transportr = (() => {
      * @param {*} [thisArg] Optional object when binding 'this' to the callback.
      */
     forEach(callback, thisArg) {
-      this._map.forEach(callback, thisArg);
+      this.#map.forEach(callback, thisArg);
     }
     /**
      * Returns an iterable of parameter names.
@@ -221,7 +222,7 @@ var Transportr = (() => {
      * @returns {IterableIterator<string>} The {@link IterableIterator} of media type parameter names.
      */
     keys() {
-      return this._map.keys();
+      return this.#map.keys();
     }
     /**
      * Returns an iterable of parameter values.
@@ -229,7 +230,7 @@ var Transportr = (() => {
      * @returns {IterableIterator<string>} The {@link IterableIterator} of media type parameter values.
      */
     values() {
-      return this._map.values();
+      return this.#map.values();
     }
     /**
      * Returns an iterable of name, value pairs for every parameter entry in the media type parameters.
@@ -237,7 +238,7 @@ var Transportr = (() => {
      * @returns {IterableIterator<Array<Array<string>>>} The media type parameter entries.
      */
     entries() {
-      return this._map.entries();
+      return this.#map.entries();
     }
     /**
      * A method that returns the default iterator for the {@link MediaTypeParameters}. Called by the semantics of the for-of statement.
@@ -245,7 +246,26 @@ var Transportr = (() => {
      * @returns {Iterator<string, string, undefined>} The {@link Symbol.iterator} for the media type parameters.
      */
     [Symbol.iterator]() {
-      return this._map[Symbol.iterator]();
+      return this.#map[Symbol.iterator]();
+    }
+    /**
+     * Returns a string representation of the media type parameters.
+     * This method is called by the `String()` function.
+     *
+     * @example
+     * const parameters = new MediaTypeParameters(new Map([['charset', 'utf-8']]));
+     * String(parameters); // 'charset=utf-8'
+     * parameters.toString(); // 'charset=utf-8'
+     * parameters + ''; // 'charset=utf-8'
+     * `${parameters}`; // 'charset=utf-8'
+     * parameters[Symbol.toStringTag]; // 'MediaTypeParameters'
+     * parameters[Symbol.toStringTag](); // 'MediaTypeParameters'
+     * Object.prototype.toString.call(parameters); // '[object MediaTypeParameters]'
+     * parameters + ''; // 'charset=utf-8'
+     * @returns {string} The string representation of the media type parameters.
+     */
+    [Symbol.toStringTag]() {
+      return "MediaTypeParameters";
     }
   };
 
@@ -254,7 +274,7 @@ var Transportr = (() => {
     input = removeLeadingAndTrailingHTTPWhitespace(input);
     let position = 0;
     let type = "";
-    while (position < input.length && input[position] !== "/") {
+    while (position < input.length && input[position] != "/") {
       type += input[position];
       ++position;
     }
@@ -266,7 +286,7 @@ var Transportr = (() => {
     }
     ++position;
     let subtype = "";
-    while (position < input.length && input[position] !== ";") {
+    while (position < input.length && input[position] != ";") {
       subtype += input[position];
       ++position;
     }
@@ -285,26 +305,26 @@ var Transportr = (() => {
         ++position;
       }
       let parameterName = "";
-      while (position < input.length && input[position] !== ";" && input[position] !== "=") {
+      while (position < input.length && input[position] != ";" && input[position] != "=") {
         parameterName += input[position];
         ++position;
       }
       parameterName = asciiLowercase(parameterName);
       if (position < input.length) {
-        if (input[position] === ";") {
+        if (input[position] == ";") {
           continue;
         }
         ++position;
       }
       let parameterValue = null;
-      if (input[position] === '"') {
+      if (input[position] == '"') {
         [parameterValue, position] = collectAnHTTPQuotedString(input, position);
-        while (position < input.length && input[position] !== ";") {
+        while (position < input.length && input[position] != ";") {
           ++position;
         }
       } else {
         parameterValue = "";
-        while (position < input.length && input[position] !== ";") {
+        while (position < input.length && input[position] != ";") {
           parameterValue += input[position];
           ++position;
         }
@@ -328,12 +348,9 @@ var Transportr = (() => {
       return serialization;
     }
     for (let [name, value] of mediaType.parameters) {
-      serialization += ";";
-      serialization += name;
-      serialization += "=";
+      serialization += `;${name}=`;
       if (!solelyContainsHTTPTokenCodePoints(value) || value.length === 0) {
-        value = value.replace(/(["\\])/ug, "\\$1");
-        value = `"${value}"`;
+        value = `"${value.replace(/(["\\])/ug, "\\$1")}"`;
       }
       serialization += value;
     }
@@ -343,32 +360,35 @@ var Transportr = (() => {
 
   // node_modules/@d1g1tal/media-type/src/media-type.js
   var MediaType = class {
+    /** @type {string} */
+    #type;
+    /** @type {string} */
+    #subtype;
+    /** @type {MediaTypeParameters} */
+    #parameters;
     /**
      * Create a new MediaType instance from a string representation.
      *
-     * @param {string} string The media type to parse
+     * @param {string} mediaType The media type to parse.
+     * @param {Object} [parameters] Optional parameters.
      */
-    constructor(string) {
-      string = String(string);
-      const result = parser_default(string);
-      if (result === null) {
-        throw new Error(`Could not parse media type string '${string}'`);
-      }
-      this._type = result.type;
-      this._subtype = result.subtype;
-      this._parameters = new MediaTypeParameters(result.parameters);
+    constructor(mediaType, parameters = {}) {
+      const { type, subtype, parameters: parsedParameters } = parser_default(mediaType);
+      this.#type = type;
+      this.#subtype = subtype;
+      this.#parameters = new MediaTypeParameters([...parsedParameters, ...Object.entries(parameters).map(([name, value]) => [asciiLowercase(name), asciiLowercase(value)])]);
     }
     /**
-     * Static factor method for parsing a media type.
+     * Static factory method for parsing a media type.
      *
-     * @param {string} string The media type to parse
-     * @returns {MediaType} The parsed {@link MediaType} object
+     * @param {string} string The media type to parse.
+     * @returns {MediaType} The parsed {@link MediaType} object or null if the string could not be parsed.
      */
     static parse(string) {
       try {
-        return new this(string);
+        return new MediaType(string);
       } catch (e) {
-        return null;
+        throw new Error(`Could not parse media type string '${string}'`);
       }
     }
     /**
@@ -377,7 +397,7 @@ var Transportr = (() => {
      * @returns {string} The media type without any parameters
      */
     get essence() {
-      return `${this.type}/${this.subtype}`;
+      return `${this.#type}/${this.#subtype}`;
     }
     /**
      * Gets the type.
@@ -385,7 +405,7 @@ var Transportr = (() => {
      * @returns {string} The type.
      */
     get type() {
-      return this._type;
+      return this.#type;
     }
     /**
      * Sets the type.
@@ -398,7 +418,7 @@ var Transportr = (() => {
       if (!solelyContainsHTTPTokenCodePoints(value)) {
         throw new Error(`Invalid type ${value}: must contain only HTTP token code points`);
       }
-      this._type = value;
+      this.#type = value;
     }
     /**
      * Gets the subtype.
@@ -406,7 +426,7 @@ var Transportr = (() => {
      * @returns {string} The subtype.
      */
     get subtype() {
-      return this._subtype;
+      return this.#subtype;
     }
     /**
      * Sets the subtype.
@@ -419,7 +439,7 @@ var Transportr = (() => {
       if (!solelyContainsHTTPTokenCodePoints(value)) {
         throw new Error(`Invalid subtype ${value}: must contain only HTTP token code points`);
       }
-      this._subtype = value;
+      this.#subtype = value;
     }
     /**
      * Gets the parameters.
@@ -427,7 +447,7 @@ var Transportr = (() => {
      * @returns {MediaTypeParameters} The media type parameters.
      */
     get parameters() {
-      return this._parameters;
+      return this.#parameters;
     }
     /**
      * Gets the serialized version of the media type.
@@ -445,9 +465,9 @@ var Transportr = (() => {
      * @returns {boolean} true if this instance represents a JavaScript media type, false otherwise.
      */
     isJavaScript({ prohibitParameters = false } = {}) {
-      switch (this._type) {
+      switch (this.#type) {
         case "text": {
-          switch (this._subtype) {
+          switch (this.#subtype) {
             case "ecmascript":
             case "javascript":
             case "javascript1.0":
@@ -460,18 +480,18 @@ var Transportr = (() => {
             case "livescript":
             case "x-ecmascript":
             case "x-javascript":
-              return !prohibitParameters || this._parameters.size === 0;
+              return !prohibitParameters || this.#parameters.size === 0;
             default:
               return false;
           }
         }
         case "application": {
-          switch (this._subtype) {
+          switch (this.#subtype) {
             case "ecmascript":
             case "javascript":
             case "x-ecmascript":
             case "x-javascript":
-              return !prohibitParameters || this._parameters.size === 0;
+              return !prohibitParameters || this.#parameters.size === 0;
             default:
               return false;
           }
@@ -486,7 +506,7 @@ var Transportr = (() => {
      * @returns {boolean} true if this instance represents an XML media type, false otherwise.
      */
     isXML() {
-      return this._subtype === "xml" && (this._type === "text" || this._type === "application") || this._subtype.endsWith("+xml");
+      return this.#subtype === "xml" && (this.#type === "text" || this.#type === "application") || this.#subtype.endsWith("+xml");
     }
     /**
      * Determines if this instance is an HTML media type.
@@ -494,7 +514,7 @@ var Transportr = (() => {
      * @returns {boolean} true if this instance represents an HTML media type, false otherwise.
      */
     isHTML() {
-      return this._subtype === "html" && this._type === "text";
+      return this.#subtype === "html" && this.#type === "text";
     }
     /**
      * Gets the name of the class.
@@ -506,6 +526,130 @@ var Transportr = (() => {
     }
   };
 
+  // node_modules/@d1g1tal/subscribr/src/context-event-handler.js
+  var ContextEventHandler = class {
+    #context;
+    #eventHandler;
+    /**
+     * @param {*} context The context to bind to the event handler.
+     * @param {function(*): void} eventHandler The event handler to call when the event is published.
+     */
+    constructor(context, eventHandler) {
+      this.#context = context;
+      this.#eventHandler = eventHandler;
+    }
+    /**
+     * Call the event handler for the provided event.
+     *
+     * @param {Event} event The event to handle
+     * @param {*} [data] The value to be passed to the event handler as a parameter.
+     */
+    handle(event, data) {
+      this.#eventHandler.call(this.#context, event, data);
+    }
+    get [Symbol.toStringTag]() {
+      return "ContextEventHandler";
+    }
+  };
+
+  // node_modules/@d1g1tal/subscribr/src/subscription.js
+  var Subscription = class {
+    #eventName;
+    #contextEventHandler;
+    /**
+     * @param {string} eventName The event name.
+     * @param {ContextEventHandler} contextEventHandler Then context event handler.
+     */
+    constructor(eventName, contextEventHandler) {
+      this.#eventName = eventName;
+      this.#contextEventHandler = contextEventHandler;
+    }
+    /**
+     * Gets the event name for the subscription.
+     *
+     * @returns {string} The event name.
+     */
+    get eventName() {
+      return this.#eventName;
+    }
+    /**
+     * Gets the context event handler.
+     *
+     * @returns {ContextEventHandler} The context event handler
+     */
+    get contextEventHandler() {
+      return this.#contextEventHandler;
+    }
+    get [Symbol.toStringTag]() {
+      return "Subscription";
+    }
+  };
+
+  // node_modules/@d1g1tal/subscribr/src/subscribr.js
+  var Subscribr = class {
+    /** @type {SetMultiMap<string, ContextEventHandler>} */
+    #subscribers;
+    constructor() {
+      this.#subscribers = new SetMultiMap();
+    }
+    /**
+     * Subscribe to an event
+     *
+     * @param {string} eventName The event name to subscribe to.
+     * @param {function(Event, *): void} eventHandler The event handler to call when the event is published.
+     * @param {*} [context] The context to bind to the event handler.
+     * @returns {Subscription} An object used to check if the subscription still exists and to unsubscribe from the event.
+     */
+    subscribe(eventName, eventHandler, context = eventHandler) {
+      const contextEventHandler = new ContextEventHandler(context, eventHandler);
+      this.#subscribers.set(eventName, contextEventHandler);
+      return new Subscription(eventName, contextEventHandler);
+    }
+    /**
+     * Unsubscribe from the event
+     *
+     * @param {Subscription} subscription The subscription to unsubscribe.
+     * @param {string} subscription.eventName The event name to subscribe to.
+     * @param {ContextEventHandler} subscription.contextEventHandler The event handler to call when the event is published.
+     * @returns {boolean} true if eventListener has been removed successfully. false if the value is not found or if the value is not an object.
+     */
+    unsubscribe({ eventName, contextEventHandler }) {
+      const contextEventHandlers = this.#subscribers.get(eventName);
+      const removed = contextEventHandlers?.delete(contextEventHandler);
+      if (removed && contextEventHandlers.size == 0) {
+        this.#subscribers.delete(eventName);
+      }
+      return removed;
+    }
+    /**
+     * Publish an event
+     *
+     * @param {string} eventName The name of the event.
+     * @param {Event} event The event to be handled.
+     * @param {*} [data] The value to be passed to the event handler as a parameter.
+     */
+    publish(eventName, event = new CustomEvent(eventName), data) {
+      if (data == null && !(event instanceof Event)) {
+        [data, event] = [event, new CustomEvent(eventName)];
+      }
+      this.#subscribers.get(eventName)?.forEach((contextEventHandler) => contextEventHandler.handle(event, data));
+    }
+    /**
+     * Check if the event and handler are subscribed.
+     *
+     * @param {Subscription} subscription The subscription object.
+     * @param {string} subscription.eventName The name of the event to check.
+     * @param {ContextEventHandler} subscription.contextEventHandler The event handler to check.
+     * @returns {boolean} true if the event name and handler are subscribed, false otherwise.
+     */
+    isSubscribed({ eventName, contextEventHandler }) {
+      return this.#subscribers.get(eventName)?.has(contextEventHandler);
+    }
+    get [Symbol.toStringTag]() {
+      return "Subscribr";
+    }
+  };
+
   // src/http-error.js
   var HttpError = class extends Error {
     /** @type {ResponseBody} */
@@ -1694,8 +1838,60 @@ var Transportr = (() => {
     }
   };
 
+  // src/signal-controller.js
+  var SignalController = class {
+    /** @type {AbortController} */
+    #abortController;
+    /**
+     * @param {AbortSignal} [signal] The signal to be used to abort the request.
+     */
+    constructor(signal) {
+      this.#abortController = new AbortController();
+      signal?.addEventListener("abort", () => this.#abortController.abort());
+    }
+    /**
+     * Returns the {@link AbortSignal} object associated with this object.
+     *
+     * @returns {AbortSignal} The {@link AbortSignal} object associated with this object.
+     */
+    get signal() {
+      return this.#abortController.signal;
+    }
+    /**
+     * Aborts a DOM request before it has completed.
+     * This is able to abort fetch requests, data sent using the XMLHttpRequest API, and Web Sockets.
+     *
+     * @param {DOMException} [reason] The reason for aborting the request.
+     * @returns {void}
+     */
+    abort(reason) {
+      this.#abortController.abort(reason);
+    }
+    /**
+     * A String value that is used in the creation of the default string
+     * description of an object. Called by the built-in method {@link Object.prototype.toString}.
+     *
+     * @override
+     * @returns {string} The default string description of this object.
+     */
+    get [Symbol.toStringTag]() {
+      return "SignalController";
+    }
+  };
+
   // src/transportr.js
   var endsWithSlashRegEx = /\/$/;
+  var charset = "utf-8";
+  var _mediaTypes = /* @__PURE__ */ new Map([
+    [http_media_type_default.PNG, new MediaType(http_media_type_default.PNG)],
+    [http_media_type_default.TEXT, new MediaType(http_media_type_default.TEXT, { charset })],
+    [http_media_type_default.JSON, new MediaType(http_media_type_default.JSON, { charset })],
+    [http_media_type_default.HTML, new MediaType(http_media_type_default.HTML, { charset })],
+    [http_media_type_default.JAVA_SCRIPT, new MediaType(http_media_type_default.JAVA_SCRIPT, { charset })],
+    [http_media_type_default.CSS, new MediaType(http_media_type_default.CSS, { charset })],
+    [http_media_type_default.XML, new MediaType(http_media_type_default.XML, { charset })],
+    [http_media_type_default.BIN, new MediaType(http_media_type_default.BIN)]
+  ]);
   var _handleText = async (response) => await response.text();
   var _handleScript = async (response) => {
     const objectURL = URL.createObjectURL(await response.blob());
@@ -1714,16 +1910,16 @@ var Transportr = (() => {
   var _handleImage = async (response) => URL.createObjectURL(await response.blob());
   var _handleBuffer = async (response) => await response.arrayBuffer();
   var _handleReadableStream = async (response) => response.body;
-  var _handleXml = async (response) => new DOMParser().parseFromString(await response.text(), http_media_type_default.XML.essence);
-  var _handleHtml = async (response) => new DOMParser().parseFromString(await response.text(), http_media_type_default.HTML.essence);
+  var _handleXml = async (response) => new DOMParser().parseFromString(await response.text(), http_media_type_default.XML);
+  var _handleHtml = async (response) => new DOMParser().parseFromString(await response.text(), http_media_type_default.HTML);
   var _handleHtmlFragment = async (response) => document.createRange().createContextualFragment(await response.text());
   var _typeConverter = (data) => Object.fromEntries(Array.from(data.keys()).map((key, index, keys, value = data.getAll(key)) => [key, value.length > 1 ? value : value[0]]));
-  var _baseUrl, _options, _contentTypeHandlers, _propertyTypeConverters, _defaultRequestOptions, _get, get_fn, _request, request_fn, _processResponse, processResponse_fn, _createUrl, createUrl_fn, _needsSerialization, needsSerialization_fn, _convertRequestOptions, convertRequestOptions_fn;
+  var _baseUrl, _options, _subscribr, _globalSubscribr, _activeRequests, _contentTypeHandlers, _propertyTypeConverters, _defaultRequestOptions, _eventResponseStatuses, _get, get_fn, _request, request_fn, _handleError, handleError_fn, _publish, publish_fn, _generateResponseStatusFromError, generateResponseStatusFromError_fn, _processResponse, processResponse_fn, _createUrl, createUrl_fn, _needsSerialization, needsSerialization_fn, _convertRequestOptions, convertRequestOptions_fn;
   var _Transportr = class {
     /**
      * Create a new Transportr instance with the provided location or origin and context path.
      *
-     * @param {URL | string | RequestOptions} [url=location.origin] The URL for {@link fetch} requests.
+     * @param {URL|string|RequestOptions} [url=location.origin] The URL for {@link fetch} requests.
      * @param {RequestOptions} [options={}] The default {@link RequestOptions} for this instance.
      */
     constructor(url = location.origin, options = {}) {
@@ -1754,10 +1950,45 @@ var Transportr = (() => {
        * @returns {Promise<ResponseBody>} The response from the API call.
        */
       __privateAdd(this, _request);
+      /**
+       * Handles an error by logging it and throwing it.
+       *
+       * @private
+       * @param {URL} url The path to the resource you want to access.
+       * @param {import('./http-error.js').HttpErrorOptions} options The options for the HttpError.
+       * @returns {HttpError} The HttpError.
+       */
+      __privateAdd(this, _handleError);
+      /**
+       * Publishes an event to the global and instance subscribers.
+       *
+       * @private
+       * @param {string} eventName The name of the event.
+       * @param {boolean} global Whether or not to publish the event to the global subscribers.
+       * @param {Event} [event] The event object.
+       * @param {*} [data] The data to pass to the subscribers.
+       * @returns {void}
+       */
+      __privateAdd(this, _publish);
+      /**
+       * It takes a response and a handler, and if the handler is not defined, it tries to find a handler
+       * based on the response's content type
+       *
+       * @private
+       * @static
+       * @async
+       * @param {Response} response - The response object returned by the fetch API.
+       * @param {URL} url - The path to the resource you want to access. Used for error handling.
+       * @param {ResponseHandler<ResponseBody>} [handler] - The handler to use for processing the response.
+       * @returns {Promise<ResponseBody>} The response is being returned.
+       */
+      __privateAdd(this, _processResponse);
       /** @type {URL} */
       __privateAdd(this, _baseUrl, void 0);
       /** @type {RequestOptions} */
       __privateAdd(this, _options, void 0);
+      /** @type {Subscribr} */
+      __privateAdd(this, _subscribr, void 0);
       var _a;
       const type = object_type_default(url);
       if (type == Object) {
@@ -1768,6 +1999,54 @@ var Transportr = (() => {
       }
       __privateSet(this, _baseUrl, url);
       __privateSet(this, _options, object_merge_default(__privateGet(_Transportr, _defaultRequestOptions), __privateMethod(_a = _Transportr, _convertRequestOptions, convertRequestOptions_fn).call(_a, options)));
+      __privateSet(this, _subscribr, new Subscribr());
+    }
+    /**
+     * Returns a {@link SignalController} used for aborting requests.
+     *
+     * @static
+     * @param {AbortSignal} [signal] The optional {@link AbortSignal} to used for chaining.
+     * @returns {SignalController} A new {@link SignalController} instance.
+     */
+    static signalController(signal) {
+      return new SignalController(signal);
+    }
+    /**
+     * Returns a {@link EventRegistration} used for subscribing to global events.
+     *
+     * @static
+     * @param {TransportrEvent} event The event to subscribe to.
+     * @param {function(Event, *): void} handler The event handler.
+     * @param {*} context The context to bind the handler to.
+     * @returns {EventRegistration} A new {@link EventRegistration} instance.
+     */
+    static register(event, handler, context) {
+      return __privateGet(_Transportr, _globalSubscribr).subscribe(event, handler, context);
+    }
+    /**
+     * Removes a {@link EventRegistration} from the global event handler.
+     *
+     * @static
+     * @param {EventRegistration} eventRegistration The {@link EventRegistration} to remove.
+     * @returns {boolean} True if the {@link EventRegistration} was removed, false otherwise.
+     */
+    static unregister(eventRegistration) {
+      return __privateGet(_Transportr, _globalSubscribr).unsubscribe(eventRegistration);
+    }
+    /**
+     * Aborts all active requests.
+     * This is useful for when the user navigates away from the current page.
+     * This will also clear the {@link Transportr#activeRequests} array.
+     * This is called automatically when the {@link Transportr#abort} method is called.
+     *
+     * @static
+     * @returns {void}
+     */
+    static abortAll() {
+      for (const signalController of __privateGet(this, _activeRequests)) {
+        signalController.abort();
+      }
+      __privateSet(this, _activeRequests, []);
     }
     /**
      * It returns the base {@link URL} for the API.
@@ -1777,6 +2056,26 @@ var Transportr = (() => {
     get baseUrl() {
       return __privateGet(this, _baseUrl);
     }
+    /**
+     * Registers an event handler with a {@link Transportr} instance.
+     *
+     * @param {TransportrEvent} event The name of the event to listen for.
+     * @param {function(Event, *): void} handler The function to call when the event is triggered.
+     * @param {*} [context] The context to bind to the handler.
+     * @returns {EventRegistration} An object that can be used to remove the event handler.
+     */
+    register(event, handler, context) {
+      return __privateGet(this, _subscribr).subscribe(event, handler, context);
+    }
+    /**
+     * Unregisters an event handler from a {@link Transportr} instance.
+     *
+     * @param {EventRegistration} eventRegistration The event registration to remove.
+     * @returns {void}
+     */
+    unregister(eventRegistration) {
+      __privateGet(this, _subscribr).unsubscribe(eventRegistration);
+    }
     /**
      * This function returns a promise that resolves to the result of a request to the specified path with
      * the specified options, where the method is GET.
@@ -1877,7 +2176,7 @@ var Transportr = (() => {
      * @returns {Promise<JsonObject>} A promise that resolves to the response body as a JSON object.
      */
     async getJson(path, options) {
-      return __privateMethod(this, _get, get_fn).call(this, path, options, { headers: { [http_request_headers_default.ACCEPT]: http_media_type_default.JSON } }, _handleJson);
+      return __privateMethod(this, _get, get_fn).call(this, path, options, { headers: { [http_request_headers_default.ACCEPT]: _mediaTypes.get(http_media_type_default.JSON).toString() } }, _handleJson);
     }
     /**
      * It gets the XML representation of the resource at the given path.
@@ -1888,7 +2187,7 @@ var Transportr = (() => {
      * @returns {Promise<Document>} The result of the function call to #get.
      */
     async getXml(path, options) {
-      return __privateMethod(this, _get, get_fn).call(this, path, options, { headers: { [http_request_headers_default.ACCEPT]: http_media_type_default.XML } }, _handleXml);
+      return __privateMethod(this, _get, get_fn).call(this, path, options, { headers: { [http_request_headers_default.ACCEPT]: _mediaTypes.get(http_media_type_default.XML).toString() } }, _handleXml);
     }
     /**
      * Get the HTML content of the specified path.
@@ -1901,7 +2200,7 @@ var Transportr = (() => {
      * method of the promise returned by the `#get` method.
      */
     async getHtml(path, options) {
-      return __privateMethod(this, _get, get_fn).call(this, path, options, { headers: { [http_request_headers_default.ACCEPT]: http_media_type_default.HTML } }, _handleHtml);
+      return __privateMethod(this, _get, get_fn).call(this, path, options, { headers: { [http_request_headers_default.ACCEPT]: _mediaTypes.get(http_media_type_default.HTML).toString() } }, _handleHtml);
     }
     /**
      * It returns a promise that resolves to the HTML fragment at the given path.
@@ -1913,7 +2212,7 @@ var Transportr = (() => {
      * @returns {Promise<DocumentFragment>} A promise that resolves to an HTML fragment.
      */
     async getHtmlFragment(path, options) {
-      return __privateMethod(this, _get, get_fn).call(this, path, options, { headers: { [http_request_headers_default.ACCEPT]: http_media_type_default.HTML } }, _handleHtmlFragment);
+      return __privateMethod(this, _get, get_fn).call(this, path, options, { headers: { [http_request_headers_default.ACCEPT]: _mediaTypes.get(http_media_type_default.HTML).toString() } }, _handleHtmlFragment);
     }
     /**
      * It gets a script from the server, and appends the script to the {@link Document} {@link HTMLHeadElement}
@@ -1925,7 +2224,7 @@ var Transportr = (() => {
      * @returns {Promise<void>} A promise that has been resolved.
      */
     async getScript(path, options) {
-      return __privateMethod(this, _get, get_fn).call(this, path, options, { headers: { [http_request_headers_default.ACCEPT]: http_media_type_default.JAVA_SCRIPT } }, _handleScript);
+      return __privateMethod(this, _get, get_fn).call(this, path, options, { headers: { [http_request_headers_default.ACCEPT]: _mediaTypes.get(http_media_type_default.JAVA_SCRIPT).toString() } }, _handleScript);
     }
     /**
      * Gets a stylesheet from the server, and adds it as a {@link Blob} {@link URL}.
@@ -1936,7 +2235,7 @@ var Transportr = (() => {
      * @returns {Promise<void>} A promise that has been resolved.
      */
     async getStylesheet(path, options) {
-      return __privateMethod(this, _get, get_fn).call(this, path, options, { headers: { [http_request_headers_default.ACCEPT]: http_media_type_default.CSS } }, _handleCss);
+      return __privateMethod(this, _get, get_fn).call(this, path, options, { headers: { [http_request_headers_default.ACCEPT]: _mediaTypes.get(http_media_type_default.CSS).toString() } }, _handleCss);
     }
     /**
      * It returns a blob from the specified path.
@@ -1995,9 +2294,13 @@ var Transportr = (() => {
   var Transportr = _Transportr;
   _baseUrl = new WeakMap();
   _options = new WeakMap();
+  _subscribr = new WeakMap();
+  _globalSubscribr = new WeakMap();
+  _activeRequests = new WeakMap();
   _contentTypeHandlers = new WeakMap();
   _propertyTypeConverters = new WeakMap();
   _defaultRequestOptions = new WeakMap();
+  _eventResponseStatuses = new WeakMap();
   _get = new WeakSet();
   get_fn = async function(path, userOptions, options, responseHandler) {
     return __privateMethod(this, _request, request_fn).call(this, path, userOptions, options, responseHandler);
@@ -2006,30 +2309,83 @@ var Transportr = (() => {
   request_fn = async function(path, userOptions = {}, options = {}, responseHandler) {
     var _a, _b, _c, _d, _e;
     const requestOptions = object_merge_default(__privateGet(this, _options), __privateMethod(_a = _Transportr, _convertRequestOptions, convertRequestOptions_fn).call(_a, userOptions), options);
-    const errorMessage = `An error has occurred with your Request: ${path}`;
-    if (__privateMethod(_b = _Transportr, _needsSerialization, needsSerialization_fn).call(_b, requestOptions.method, requestOptions.headers[http_request_headers_default.CONTENT_TYPE])) {
-      requestOptions.body = JSON.stringify(requestOptions.body);
+    const url = __privateMethod(_b = _Transportr, _createUrl, createUrl_fn).call(_b, __privateGet(this, _baseUrl), path, requestOptions.searchParams);
+    const signalController = new SignalController(requestOptions.signal);
+    __privateGet(_Transportr, _activeRequests).push(signalController);
+    requestOptions.signal = signalController.signal;
+    if (__privateMethod(_c = _Transportr, _needsSerialization, needsSerialization_fn).call(_c, requestOptions.method, requestOptions.headers[http_request_headers_default.CONTENT_TYPE])) {
+      try {
+        requestOptions.body = JSON.stringify(requestOptions.body);
+      } catch (error) {
+        return Promise.reject(new HttpError(url, { cause: error }));
+      }
     } else if (requestOptions.method == http_request_methods_default.GET && requestOptions.headers[http_request_headers_default.CONTENT_TYPE] != "") {
       delete requestOptions.headers[http_request_headers_default.CONTENT_TYPE];
       delete requestOptions.body;
     }
-    let response;
+    requestOptions.signal.addEventListener("abort", (event) => __privateMethod(this, _publish, publish_fn).call(this, _Transportr.Events.ABORTED, requestOptions.global, event));
+    requestOptions.signal.addEventListener("timeout", (event) => __privateMethod(this, _publish, publish_fn).call(this, _Transportr.Events.TIMEOUT, requestOptions.global, event));
+    __privateMethod(this, _publish, publish_fn).call(this, _Transportr.Events.CONFIGURED, requestOptions.global, requestOptions);
+    let result, timeoutId, response;
     try {
-      response = await fetch(__privateMethod(_c = _Transportr, _createUrl, createUrl_fn).call(_c, __privateGet(this, _baseUrl), path, requestOptions.searchParams), requestOptions);
+      timeoutId = setTimeout(() => {
+        const cause = new DOMException(`The call to '${url}' timed-out after ${requestOptions.timeout / 1e3} seconds`, "TimeoutError");
+        signalController.abort(cause);
+        requestOptions.signal.dispatchEvent(new CustomEvent(_Transportr.Events.TIMEOUT, { detail: { url, options: requestOptions, cause } }));
+      }, requestOptions.timeout);
+      response = await fetch(url, requestOptions);
+      if (!response.ok) {
+        return Promise.reject(__privateMethod(this, _handleError, handleError_fn).call(this, url, { status: __privateMethod(_d = _Transportr, _generateResponseStatusFromError, generateResponseStatusFromError_fn).call(_d, "ResponseError", response), entity: await __privateMethod(this, _processResponse, processResponse_fn).call(this, response, url) }));
+      }
+      result = await __privateMethod(this, _processResponse, processResponse_fn).call(this, response, url, responseHandler);
+      __privateMethod(this, _publish, publish_fn).call(this, _Transportr.Events.SUCCESS, requestOptions.global, result);
     } catch (error) {
-      console.error(errorMessage, error);
-      throw new HttpError(errorMessage, { cause: error, status: response ? new ResponseStatus(response.status, response.statusText) : new ResponseStatus(0, "Unknown") });
+      return Promise.reject(__privateMethod(this, _handleError, handleError_fn).call(this, url, { cause: error, status: __privateMethod(_e = _Transportr, _generateResponseStatusFromError, generateResponseStatusFromError_fn).call(_e, error.name, response) }));
+    } finally {
+      clearTimeout(timeoutId);
+      if (!requestOptions.signal.aborted) {
+        __privateMethod(this, _publish, publish_fn).call(this, _Transportr.Events.COMPLETE, requestOptions.global, response);
+        const index = __privateGet(_Transportr, _activeRequests).indexOf(signalController);
+        if (index > -1) {
+          __privateGet(_Transportr, _activeRequests).splice(index, 1);
+        }
+        if (__privateGet(_Transportr, _activeRequests).length === 0) {
+          __privateMethod(this, _publish, publish_fn).call(this, _Transportr.Events.ALL_COMPLETE, requestOptions.global, response);
+        }
+      }
+    }
+    return result;
+  };
+  _handleError = new WeakSet();
+  handleError_fn = function(url, options) {
+    const error = new HttpError(`An error has occurred with your request to: '${url}'`, options);
+    __privateMethod(this, _publish, publish_fn).call(this, _Transportr.Events.ERROR, true, error);
+    return error;
+  };
+  _publish = new WeakSet();
+  publish_fn = function(eventName, global, event, data) {
+    if (global) {
+      __privateGet(_Transportr, _globalSubscribr).publish(eventName, event, data);
     }
-    if (!response.ok) {
-      throw new HttpError(errorMessage, { status: new ResponseStatus(response.status, response.statusText), entity: await __privateMethod(_d = _Transportr, _processResponse, processResponse_fn).call(_d, response) });
+    __privateGet(this, _subscribr).publish(eventName, event, data);
+  };
+  _generateResponseStatusFromError = new WeakSet();
+  generateResponseStatusFromError_fn = function(errorName, response) {
+    switch (errorName) {
+      case "AbortError":
+        return __privateGet(_Transportr, _eventResponseStatuses).get(_Transportr.Events.ABORTED);
+      case "TimeoutError":
+        return __privateGet(_Transportr, _eventResponseStatuses).get(_Transportr.Events.TIMEOUT);
+      default:
+        return response ? new ResponseStatus(response.status, response.statusText) : new ResponseStatus(500, "Internal Server Error");
     }
-    return await __privateMethod(_e = _Transportr, _processResponse, processResponse_fn).call(_e, response, responseHandler);
   };
   _processResponse = new WeakSet();
-  processResponse_fn = async function(response, handler) {
+  processResponse_fn = async function(response, url, handler) {
     try {
+      let mediaType;
       if (!handler) {
-        const mediaType = new MediaType(response.headers.get(http_response_headers_default.CONTENT_TYPE));
+        mediaType = MediaType.parse(response.headers.get(http_response_headers_default.CONTENT_TYPE));
         if (mediaType) {
           for (const [responseHandler, contentTypes] of __privateGet(_Transportr, _contentTypeHandlers)) {
             if (contentTypes.has(mediaType.type) || contentTypes.has(mediaType.subtype)) {
@@ -2041,20 +2397,21 @@ var Transportr = (() => {
       }
       return (handler ?? _handleText)(response);
     } catch (error) {
-      const errorMessage = "Unable to process response.";
-      console.error(errorMessage, error, response);
-      throw new HttpError(errorMessage, { cause: error });
+      console.error("Unable to process response.", error, response);
+      return Promise.reject(__privateMethod(this, _handleError, handleError_fn).call(this, url, { cause: error }));
     }
   };
   _createUrl = new WeakSet();
   createUrl_fn = function(url, path, searchParams = {}) {
-    url = path.startsWith("/") ? new URL(`${url.pathname.replace(endsWithSlashRegEx, "")}${path}`, url.origin) : new URL(path);
+    if (path) {
+      url = path.startsWith("/") ? new URL(`${url.pathname.replace(endsWithSlashRegEx, "")}${path}`, url.origin) : new URL(path);
+    }
     Object.entries(searchParams).forEach(([key, value]) => url.searchParams.append(key, value));
     return url;
   };
   _needsSerialization = new WeakSet();
   needsSerialization_fn = function(method, contentType) {
-    return contentType == http_media_type_default.JSON && [http_request_methods_default.POST, http_request_methods_default.PUT, http_request_methods_default.PATCH].includes(method);
+    return (_mediaTypes.get(contentType) ?? new MediaType(contentType)).essence == http_media_type_default.JSON && [http_request_methods_default.POST, http_request_methods_default.PUT, http_request_methods_default.PATCH].includes(method);
   };
   _convertRequestOptions = new WeakSet();
   convertRequestOptions_fn = function(options) {
@@ -2068,17 +2425,15 @@ var Transportr = (() => {
     return options;
   };
   /**
-   * It takes a response and a handler, and if the handler is not defined, it tries to find a handler
-   * based on the response's content type
+   * Generates a ResponseStatus object based on the error name and the response.
    *
    * @private
    * @static
-   * @async
-   * @param {Response} response - The response object returned by the fetch API.
-   * @param {ResponseHandler<ResponseBody>} [handler] - The handler to use for processing the response.
-   * @returns {Promise<ResponseBody>} The response is being returned.
+   * @param {string} errorName The name of the error.
+   * @param {Response} response The response object returned by the fetch API.
+   * @returns {ResponseStatus} The response status object.
    */
-  __privateAdd(Transportr, _processResponse);
+  __privateAdd(Transportr, _generateResponseStatusFromError);
   /**
    * It takes a URL, a path, and a set of search parameters, and returns a new URL with the path and
    * search parameters applied.
@@ -2109,20 +2464,24 @@ var Transportr = (() => {
    * @returns {RequestOptions} The options to use for the request.
    */
   __privateAdd(Transportr, _convertRequestOptions);
+  /** @type {Subscribr} */
+  __privateAdd(Transportr, _globalSubscribr, new Subscribr());
+  /** @type {Array<SignalController>} */
+  __privateAdd(Transportr, _activeRequests, []);
   /**
    * @private
    * @static
    * @type {SetMultiMap<ResponseHandler<ResponseBody>, string>}
    */
   __privateAdd(Transportr, _contentTypeHandlers, new SetMultiMap([
-    [_handleImage, new MediaType(http_media_type_default.PNG).type],
-    [_handleText, new MediaType(http_media_type_default.TEXT).type],
-    [_handleJson, new MediaType(http_media_type_default.JSON).subtype],
-    [_handleHtml, new MediaType(http_media_type_default.HTML).subtype],
-    [_handleScript, new MediaType(http_media_type_default.JAVA_SCRIPT).subtype],
-    [_handleCss, new MediaType(http_media_type_default.CSS).subtype],
-    [_handleXml, new MediaType(http_media_type_default.XML).subtype],
-    [_handleReadableStream, new MediaType(http_media_type_default.BIN).subtype]
+    [_handleImage, _mediaTypes.get(http_media_type_default.PNG).type],
+    [_handleText, _mediaTypes.get(http_media_type_default.TEXT).type],
+    [_handleJson, _mediaTypes.get(http_media_type_default.JSON).subtype],
+    [_handleHtml, _mediaTypes.get(http_media_type_default.HTML).subtype],
+    [_handleScript, _mediaTypes.get(http_media_type_default.JAVA_SCRIPT).subtype],
+    [_handleCss, _mediaTypes.get(http_media_type_default.CSS).subtype],
+    [_handleXml, _mediaTypes.get(http_media_type_default.XML).subtype],
+    [_handleReadableStream, _mediaTypes.get(http_media_type_default.BIN).subtype]
   ]));
   /**
    * @private
@@ -2209,6 +2568,19 @@ var Transportr = (() => {
     STRICT_ORIGIN_WHEN_CROSS_ORIGIN: "strict-origin-when-cross-origin",
     UNSAFE_URL: "unsafe-url"
   }));
+  /**
+   * @static
+   * @constant {Object<string, TransportrEvent>}
+   */
+  __publicField(Transportr, "Events", Object.freeze({
+    CONFIGURED: "configured",
+    SUCCESS: "success",
+    ERROR: "error",
+    ABORTED: "aborted",
+    TIMEOUT: "timeout",
+    COMPLETE: "complete",
+    ALL_COMPLETE: "all-complete"
+  }));
   /**
    * @private
    * @static
@@ -2218,7 +2590,7 @@ var Transportr = (() => {
     body: null,
     cache: _Transportr.CachingPolicy.NO_STORE,
     credentials: _Transportr.CredentialsPolicy.SAME_ORIGIN,
-    headers: { [http_request_headers_default.CONTENT_TYPE]: _Transportr.MediaType.JSON, [http_request_headers_default.ACCEPT]: _Transportr.MediaType.JSON },
+    headers: { [http_request_headers_default.CONTENT_TYPE]: _mediaTypes.get(http_media_type_default.JSON).toString(), [http_request_headers_default.ACCEPT]: _mediaTypes.get(http_media_type_default.JSON).toString() },
     searchParams: {},
     integrity: void 0,
     keepalive: void 0,
@@ -2227,9 +2599,20 @@ var Transportr = (() => {
     redirect: _Transportr.RedirectPolicy.FOLLOW,
     referrer: "about:client",
     referrerPolicy: _Transportr.ReferrerPolicy.STRICT_ORIGIN_WHEN_CROSS_ORIGIN,
-    signal: null,
+    signal: void 0,
+    timeout: 1e4,
+    global: true,
     window: null
   }));
+  /**
+   * @private
+   * @static
+   * @type {Map<TransportrEvent, ResponseStatus>}
+   */
+  __privateAdd(Transportr, _eventResponseStatuses, /* @__PURE__ */ new Map([
+    [_Transportr.Events.ABORTED, new ResponseStatus(499, "Aborted")],
+    [_Transportr.Events.TIMEOUT, new ResponseStatus(504, "Gateway Timeout")]
+  ]));
   return __toCommonJS(transportr_exports);
 })();
 window.Transportr = Transportr.default;