webhoster 0.3.3 → 0.3.5

package/.test/urlencoded.js

@@ -1,54 +0,0 @@
-/**
- * @param buffer
- */
-function decode(buffer) {
-  const sequences = [];
-  let startIndex = 0;
-  for (let i = 0; i < buffer.length; i += 1) {
-    if (buffer[i] === 0x26) {
-      sequences.push(buffer.subarray(startIndex, i));
-      startIndex = i + 1;
-    }
-    if (i === buffer.length - 1) {
-      sequences.push(buffer.subarray(startIndex, i));
-    }
-  }
-  console.log(buffer);
-  console.log(sequences);
-  /** @type {[string, string][]} */
-  const output = [];
-  sequences.forEach((bytes) => {
-    if (!bytes.length) return;
-
-    // Find 0x3D and replace 0x2B in one loop for better performance
-    let indexOf0x3D = -1;
-    for (let i = 0; i < bytes.length; i += 1) {
-      switch (bytes[i]) {
-        case 0x3D:
-          if (indexOf0x3D === -1) {
-            indexOf0x3D = i;
-          }
-          break;
-        case 0x2B:
-          bytes[i] = 0x20;
-          break;
-        default:
-      }
-    }
-    let name;
-    let value;
-    if (indexOf0x3D === -1) {
-      name = bytes;
-      value = bytes.subarray(bytes.length, 0);
-    } else {
-      name = bytes.subarray(0, indexOf0x3D);
-      value = bytes.subarray(indexOf0x3D + 1);
-    }
-    const nameString = decodeURIComponent(name.toString('utf-8'));
-    const valueString = decodeURIComponent(value.toString('utf-8'));
-    output.push([nameString, valueString]);
-  });
-  return output;
-}
-
-console.log(decode(Buffer.from('field1=Ƣvalue1&field2=value2&&&=&==')));

package/.vscode/launch.json

@@ -1,35 +0,0 @@
-{
-  // Use IntelliSense to learn about possible attributes.
-  // Hover to view descriptions of existing attributes.
-  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-  "version": "0.2.0",
-  "configurations": [
-    {
-      "name": "Debug AVA",
-      "request": "launch",
-      "runtimeArgs": [
-        "run-script",
-        "debug-test"
-      ],
-      "runtimeExecutable": "npm",
-      "skipFiles": [
-        "<node_internals>/**"
-      ],
-      "type": "pwa-node"
-    },
-    {
-      "type": "node",
-      "request": "launch",
-      "name": "Debug AVA test file",
-      "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/ava",
-      "runtimeArgs": [
-        "--serial",
-        "${file}"
-      ],
-      "outputCapture": "std",
-      "skipFiles": [
-        "<node_internals>/**/*.js"
-      ]
-    },
-  ]
-}

package/.vscode/settings.json

@@ -1,5 +0,0 @@
-{
-  "javascript.preferences.importModuleSpecifier": "relative",
-  "javascript.preferences.importModuleSpecifierEnding": "js",
-  "javascript.preferences.quoteStyle": "single"
-}

package/CHANGELOG.md

@@ -1,10 +0,0 @@
-## v0.0.5
-  * Fix SocketIO errata
-
-## v0.0.4
-  * Add CommonJS support
-  * Add `HttpListener` helper
-  * Add SocketIO errata
-
-## v0.0.3
-  * Rename RequestHandler to HttpHandler

package/CODE_OF_CONDUCT.md

@@ -1,76 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, sex characteristics, gender identity and expression,
-level of experience, education, socio-economic status, nationality, personal
-appearance, race, religion, or sexual identity and orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to creating a positive environment
-include:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery and unwelcome sexual attention or
- advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
- address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
- professional setting
-
-## Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
-
-## Scope
-
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at clshortfuse@gmail.com. All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
-
-[homepage]: https://www.contributor-covenant.org
-
-For answers to common questions about this code of conduct, see
-https://www.contributor-covenant.org/faq

package/errata/index.js

@@ -1 +0,0 @@
-export * as socketio from './socketio.js';

package/examples/starter.js

@@ -1,11 +0,0 @@
-import * as starter from '../templates/starter.js';
-
-const middleware = [
-  () => 'Hello world!',
-];
-
-// Start the singleton HTTP server using the starter convenience API.
-await starter.start({ middleware });
-
-// Export nothing — this example file is intended as a tiny runnable demo.
-export {};

package/index.js

@@ -1,4 +0,0 @@
-export * as lib from './lib/index.js';
-export * as helpers from './helpers/index.js';
-export * as middleware from './middleware/index.js';
-export * as errata from './errata/index.js';

package/jsconfig.json

@@ -1,12 +0,0 @@
-{
-  "compilerOptions": {
-    "checkJs": true,
-    "noImplicitAny": true,
-    "target": "es2022",
-    "module": "esnext",
-    "moduleResolution": "node"
-  },
-  "exclude": [
-    "**/node_modules/*"
-  ]
-}

package/lib/index.js

@@ -1,3 +0,0 @@
-export { default as HttpRequest } from './HttpRequest.js';
-export { default as HttpResponse } from './HttpResponse.js';
-export { default as HttpHandler } from './HttpHandler.js';

package/middleware/ContentReaderMiddleware.js

@@ -1,249 +0,0 @@
-import { PassThrough, Transform } from 'stream';
-
-/** @typedef {import('stream').Readable} Readable */
-/** @typedef {import('../types').IMiddleware} IMiddleware */
-/** @typedef {import('../types').MiddlewareFunction} MiddlewareFunction */
-/** @typedef {import('../types').MiddlewareFunctionParams} MiddlewareFunctionParams */
-/** @typedef {import('../types').MiddlewareFunctionResult} MiddlewareFunctionResult */
-
-/**
- * @typedef {Object} ContentReaderMiddlewareOptions
- * @prop {string} [defaultMediaType]
- * Assumed mediatype if not specified
- * @prop {boolean} [parseJSON=false]
- * Automatically parses JSON if `application/json` mediatype
- * @prop {'entries'|'object'|'string'|'none'} [formURLEncodedFormat='none']
- * Automatically converts to object if `application/x-www-form-urlencoded` mediatype
- * @prop {boolean} [buildString=false]
- * Automatically builds string into one `read()` response
- * @prop {boolean|string} [cache=false]
- * Caches content in req.local.content or req.local[cacheName]
- */
-
-/** @implements {IMiddleware} */
-export default class ContentReaderMiddleware {
-  /** @param {ContentReaderMiddlewareOptions} [options] */
-  constructor(options = {}) {
-    this.defaultMediaType = options.defaultMediaType;
-    this.parseJSON = options.parseJSON === true;
-    this.formURLEncodedFormat = options.formURLEncodedFormat || 'none';
-    this.buildString = options.buildString === true;
-    this.cache = options.cache;
-  }
-
-  /**
-   * @param {string} charset
-   * @return {BufferEncoding}
-   */
-  static charsetAsBufferEncoding(charset) {
-    switch (charset) {
-      case 'iso-8859-1':
-      case 'ascii':
-      case 'binary':
-      case 'latin1':
-        return 'latin1';
-      case 'utf-16le':
-      case 'ucs-2':
-      case 'ucs2':
-      case 'utf16le':
-        return 'utf16le';
-      default:
-      case 'utf-8':
-      case 'utf8':
-        return 'utf-8';
-      case 'base64':
-      case 'hex':
-        return /** @type {BufferEncoding} */ (charset);
-    }
-  }
-
-  /**
-   * The application/x-www-form-urlencoded format is in many ways an aberrant monstrosity,
-   * the result of many years of implementation accidents and compromises leading to a set of
-   * requirements necessary for interoperability, but in no way representing good design practices.
-   * In particular, readers are cautioned to pay close attention to the twisted details
-   * involving repeated (and in some cases nested) conversions between character encodings and byte sequences.
-   * Unfortunately the format is in widespread use due to the prevalence of HTML forms. [HTML]
-   * @param {Buffer} buffer
-   * @param {string} charset
-   * @return {[string, string][]} Tuple
-   */
-  static readUrlEncoded(buffer, charset) {
-  // https://url.spec.whatwg.org/#urlencoded-parsing
-    const bufferEncoding = ContentReaderMiddleware.charsetAsBufferEncoding(charset);
-
-    const sequences = [];
-    let startIndex = 0;
-    for (let i = 0; i < buffer.length; i += 1) {
-      if (buffer[i] === 0x26) {
-        sequences.push(buffer.subarray(startIndex, i));
-        startIndex = i + 1;
-      }
-      if (i === buffer.length - 1) {
-        sequences.push(buffer.subarray(startIndex, i + 1));
-        break;
-      }
-    }
-    /** @type {[string, string][]} */
-    const output = [];
-    sequences.forEach((bytes) => {
-      if (!bytes.length) return;
-
-      // Find 0x3D and replace 0x2B in one loop for better performance
-      let indexOf0x3D = -1;
-      for (let i = 0; i < bytes.length; i += 1) {
-        switch (bytes[i]) {
-          case 0x3D:
-            if (indexOf0x3D === -1) {
-              indexOf0x3D = i;
-            }
-            break;
-          case 0x2B:
-          // Replace bytes on original stream for memory conservation
-          // eslint-disable-next-line no-param-reassign
-            bytes[i] = 0x20;
-            break;
-          default:
-        }
-      }
-      let name;
-      let value;
-      if (indexOf0x3D === -1) {
-        name = bytes;
-        value = bytes.subarray(bytes.length, 0);
-      } else {
-        name = bytes.subarray(0, indexOf0x3D);
-        value = bytes.subarray(indexOf0x3D + 1);
-      }
-      const nameString = decodeURIComponent(name.toString(bufferEncoding));
-      const valueString = decodeURIComponent(value.toString(bufferEncoding));
-      output.push([nameString, valueString]);
-    });
-    return output;
-  }
-
-  /**
-   * @param {MiddlewareFunctionParams} params
-   * @return {MiddlewareFunctionResult}
-   */
-  execute({ req }) {
-    switch (req.method) {
-      case 'HEAD':
-      case 'GET':
-        return 'continue';
-      default:
-    }
-
-    const contentType = (req.headers['content-type']);
-    /** @type {string} */
-    let mediaType;
-    /** @type {string} */
-    let charset;
-    if (contentType) {
-      contentType.split(';').forEach((directive) => {
-        const parameters = directive.split('=');
-        if (parameters.length === 1) {
-          mediaType = directive.trim().toLowerCase();
-          return;
-        }
-        if (parameters[0].trim().toLowerCase() !== 'charset') {
-          return;
-        }
-        charset = parameters[1]?.trim().toLowerCase();
-        const firstQuote = charset.indexOf('"');
-        const lastQuote = charset.lastIndexOf('"');
-        if (firstQuote !== -1 && lastQuote !== -1) {
-          charset = charset.substring(firstQuote + 1, lastQuote);
-        }
-      });
-    }
-
-    if (!mediaType) {
-      mediaType = this.defaultMediaType;
-    }
-    const isFormUrlEncoded = mediaType === 'application/x-www-form-urlencoded';
-    const isJSON = /application\/(.+\+)?json/i.test(mediaType);
-    if (!charset) {
-      if (!mediaType) {
-        return 'continue';
-      }
-      if (isFormUrlEncoded && (this.formURLEncodedFormat || 'none') === 'none') {
-        return 'continue';
-      }
-      if (!isFormUrlEncoded && !isJSON && !mediaType.startsWith('text/')) {
-        return 'continue';
-      }
-    }
-
-    const readAll = isJSON || isFormUrlEncoded;
-
-    let fullString = '';
-    /** @type {Buffer[]} */
-    const pendingChunks = [];
-    const source = req.stream;
-    const {
-      buildString, formURLEncodedFormat, cache, parseJSON,
-    } = this;
-    const newReadable = new Transform({
-      objectMode: true,
-      read(...args) {
-        if (source.isPaused()) source.resume();
-        // eslint-disable-next-line no-underscore-dangle
-        Transform.prototype._read.call(this, ...args);
-      },
-      transform(chunk, encoding, callback) {
-        if (typeof chunk === 'string') {
-          if (readAll || buildString) {
-            fullString += chunk;
-          } else {
-            this.push(chunk);
-          }
-        } else if (isFormUrlEncoded) {
-          pendingChunks.push(chunk);
-        } else {
-          this.push(chunk);
-        }
-        callback();
-      },
-      flush(callback) {
-        let result = null;
-        if (isFormUrlEncoded) {
-          const combinedBuffer = Buffer.concat(pendingChunks);
-          if (formURLEncodedFormat === 'object') {
-            result = Object.fromEntries(ContentReaderMiddleware.readUrlEncoded(combinedBuffer, charset));
-          } else if (formURLEncodedFormat === 'string') {
-            result = combinedBuffer.toString(ContentReaderMiddleware.charsetAsBufferEncoding(charset));
-          } else {
-            result = ContentReaderMiddleware.readUrlEncoded(combinedBuffer, charset);
-          }
-        } else if (isJSON && parseJSON) {
-          try {
-            result = JSON.parse(fullString);
-          } catch {
-            result = fullString;
-          }
-        } else if (fullString) {
-          result = fullString;
-        }
-        if (cache && result) {
-          const cacheName = cache === true ? 'content' : cache;
-          req.locals[cacheName] = result;
-        }
-        callback(null, result);
-      },
-    });
-    req.replaceStream(newReadable);
-    if (!isFormUrlEncoded) {
-    // Data read from source will be decoded as a string
-      const encoding = ContentReaderMiddleware.charsetAsBufferEncoding(charset);
-      const stringDecoder = new PassThrough({ encoding });
-      newReadable.setDefaultEncoding(encoding);
-      source.pipe(stringDecoder).pipe(newReadable);
-    } else {
-      source.pipe(newReadable);
-    }
-    source.pause();
-
-    return 'continue';
-  }
-}

package/middleware/ContentWriterMiddleware.js

@@ -1,161 +0,0 @@
-import { Transform } from 'node:stream';
-
-/** @typedef {import('../types').IMiddleware} IMiddleware */
-/** @typedef {import('../types').MiddlewareFunction} MiddlewareFunction */
-/** @typedef {import('../types').MiddlewareFunctionParams} MiddlewareFunctionParams */
-/** @typedef {import('../types').MiddlewareFunctionResult} MiddlewareFunctionResult */
-
-/**
- * @typedef {Object} ContentWriterMiddlewareOptions
- * @prop {string} [defaultCharset='utf-8']
- * @prop {boolean} [setCharset=false]
- * Automatically applies charset in `Content-Type`
- * @prop {boolean} [setJSON=false]
- * Automatically applies `application/json` mediatype in `Content-Type`
- * @prop {boolean|string} [cache=false]
- * Caches content in res.local.content or res.local[cacheName]
- */
-
-/** @implements {IMiddleware} */
-export default class ContentWriterMiddleware {
-  /** @param {ContentWriterMiddlewareOptions} [options] */
-  constructor(options = {}) {
-    this.defaultCharset = options.defaultCharset || 'utf-8';
-    this.setCharset = options.setCharset === true;
-    this.setJSON = options.setJSON === true;
-    this.cache = options.cache;
-  }
-
-  /**
-   * @param {string} charset
-   * @return {BufferEncoding}
-   */
-  static charsetAsBufferEncoding(charset) {
-    switch (charset) {
-      case 'iso-8859-1':
-      case 'ascii':
-      case 'binary':
-      case 'latin1':
-        return 'latin1';
-      case 'utf-16le':
-      case 'ucs-2':
-      case 'ucs2':
-      case 'utf16le':
-        return 'utf16le';
-      case 'base64':
-      case 'hex':
-        return /** @type {BufferEncoding} */ (charset);
-      case 'utf-8':
-      case 'utf8':
-      default:
-        return 'utf-8';
-    }
-  }
-
-  /**
-   * @param {MiddlewareFunctionParams} params
-   * @return {MiddlewareFunctionResult}
-   */
-  execute({ req, res }) {
-    if (req.method === 'HEAD') {
-      return 'continue';
-    }
-
-    /** @type {string} */
-    let charset = null;
-    /** @type {BufferEncoding} */
-    let encoding = null;
-    let hasSetJSON = false;
-
-    /** @return {string} */
-    const parseCharset = () => {
-      if (charset) return charset;
-      /** @type {string} */
-      const contentType = (res.headers['content-type']);
-      if (contentType) {
-        contentType.split(';').some((directive) => {
-          const parameters = directive.split('=');
-          if (parameters[0].trim().toLowerCase() !== 'charset') {
-            return false;
-          }
-          charset = parameters[1]?.trim().toLowerCase();
-          const firstQuote = charset.indexOf('"');
-          const lastQuote = charset.lastIndexOf('"');
-          if (firstQuote !== -1 && lastQuote !== -1) {
-            charset = charset.substring(firstQuote + 1, lastQuote);
-          }
-          return true;
-        });
-      }
-      if (!charset) {
-        charset = this.defaultCharset || 'utf-8';
-        if (this.setCharset && !res.headersSent) {
-          res.headers['content-type'] = `${contentType || ''};charset=${charset}`;
-        }
-      }
-      return charset;
-    };
-
-    /** @return {void} */
-    const setJSONMediaType = () => {
-      if (hasSetJSON) return;
-      /** @type {string} */
-      const contentType = (res.headers['content-type']);
-      res.headers['content-type'] = (contentType || '')
-        .split(';')
-        .map((directive) => {
-          const isKeyPair = directive.includes('=');
-          if (isKeyPair) return directive;
-          return 'application/json';
-        })
-        .join(';');
-
-      hasSetJSON = true;
-    };
-
-    const newWritable = new Transform({
-      writableObjectMode: true,
-      transform: (chunk, e, callback) => {
-        if (Buffer.isBuffer(chunk)) {
-          callback(null, chunk);
-          return;
-        }
-        const cacheName = this.cache && (this.cache === true ? 'content' : this.cache);
-        if (typeof chunk === 'string') {
-          if (!encoding) {
-            encoding = ContentWriterMiddleware.charsetAsBufferEncoding(parseCharset());
-          }
-          if (cacheName) {
-            if (typeof res.locals[cacheName] === 'string') {
-              res.locals[cacheName] += chunk;
-            } else {
-              res.locals[cacheName] = chunk;
-            }
-          }
-          const callbackData = Buffer.from(chunk, encoding);
-          callback(null, callbackData);
-          return;
-        }
-        if (cacheName) {
-          res.locals[cacheName] = chunk;
-        }
-        if (typeof chunk === 'object') {
-          if (!encoding) {
-            encoding = ContentWriterMiddleware.charsetAsBufferEncoding(parseCharset());
-          }
-          if (this.setJSON && !hasSetJSON && !res.headersSent) {
-            setJSONMediaType();
-          }
-          callback(null, Buffer.from(JSON.stringify(chunk), encoding));
-          return;
-        }
-
-        callback(null, chunk);
-      },
-    });
-    const destination = res.replaceStream(newWritable);
-    newWritable.pipe(destination);
-
-    return 'continue';
-  }
-}

package/middleware/SendHeadersMiddleware.js

@@ -1,47 +0,0 @@
-import { PassThrough } from 'stream';
-
-/** @typedef {import('../types').IMiddleware} IMiddleware */
-/** @typedef {import('../types').MiddlewareFunction} MiddlewareFunction */
-/** @typedef {import('../types').MiddlewareFunctionParams} MiddlewareFunctionParams */
-/** @typedef {import('../types').MiddlewareFunctionResult} MiddlewareFunctionResult */
-
-/**
- * @typedef {Object} SendHeadersMiddlewareOptions
- * @prop {boolean} [setStatus=false]
- * Automatically set `200` or `204` status if not set
- */
-
-/** @implements {IMiddleware} */
-export default class SendHeadersMiddleware {
-  /** @param {SendHeadersMiddlewareOptions} options */
-  constructor(options = {}) {
-    this.setStatus = options.setStatus === true;
-  }
-
-  /**
-   * @param {MiddlewareFunctionParams} params
-   * @return {MiddlewareFunctionResult}
-   */
-  execute({ res }) {
-    const newWritable = new PassThrough();
-    const destination = res.replaceStream(newWritable);
-    newWritable.once('data', () => {
-      if (!res.headersSent) {
-        if (this.setStatus && res.status == null) {
-          res.status = 200;
-        }
-        res.sendHeaders(false);
-      }
-    });
-    newWritable.on('end', () => {
-      if (!res.headersSent) {
-        if (this.setStatus && res.status == null) {
-          res.status = 204;
-        }
-        res.sendHeaders(false);
-      }
-    });
-    newWritable.pipe(destination);
-    return 'continue';
-  }
-}