webhoster 0.3.7 → 0.3.8

package/README.md

@@ -31,6 +31,10 @@ By default, the framework does nothing. It parses no headers. It writes no heade
 
 For now, take a look at [/test/index.js](/test/index.js)
 
+## Docs
+
+Start at [docs/README.md](./docs/README.md) for the documentation index.
+
 ## Core
 
 ### [HttpHandler.js](/lib/HttpHandler.js)

package/middleware/ReadFormData.js

@@ -70,9 +70,12 @@ async function parseFormUrlEncoded(request) {
 const CONTENT_READER = {
   type: 'application',
   subtype: 'x-www-form-urlencoded',
-  parse: async (/** @type {HttpRequest} */ request) => Object.fromEntries(
-    await parseFormUrlEncoded(request),
-  ),
+  /** @this {HttpRequest} */
+  parse: async function parse() {
+    return Object.fromEntries(
+      await parseFormUrlEncoded(this),
+    );
+  },
 };
 
 /**

package/package.json

@@ -18,7 +18,9 @@
     "eslint-plugin-canonical": "^4.18.1",
     "eslint-plugin-jsdoc": "^46.10.1",
     "eslint-plugin-n": "^16.6.2",
-    "eslint-plugin-unicorn": "^48.0.1"
+    "eslint-plugin-unicorn": "^48.0.1",
+    "rimraf": "^4.4.1",
+    "typescript": "^5.9.3"
   },
   "engines": {
     "node": ">v16.13"
@@ -26,11 +28,10 @@
   "exports": {
     "./data/*": "./data/*",
     "./errata/*": "./errata/*",
-    "./examples/*": "./examples/*",
     "./helpers/*": "./helpers/*",
     "./lib/*": "./lib/*",
     "./middleware/*": "./middleware/*",
-    "./polyfills/*": "./polyfills/*",
+    "./polyfill/*": "./polyfill/*",
     "./templates/*": "./templates/*",
     "./types/*": "./types/*",
     "./utils/*": "./utils/*"
@@ -52,7 +53,7 @@
     "helpers",
     "lib",
     "middleware",
-    "polyfills",
+    "polyfill",
     "templates",
     "types",
     "utils"
@@ -70,6 +71,14 @@
     "testall": "scripts/test-all.sh",
     "posttestall": "c8 report"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/clshortfuse/webhoster.git"
+  },
+  "bugs": {
+    "url": "https://github.com/clshortfuse/webhoster/issues"
+  },
+  "homepage": "https://github.com/clshortfuse/webhoster#readme",
   "type": "module",
   "typesVersions": {
     "*": {
@@ -78,5 +87,5 @@
       ]
     }
   },
-  "version": "0.3.7"
-}
+  "version": "0.3.8"
+}

package/polyfill/FormData.js

@@ -0,0 +1,164 @@
+/* @see https://xhr.spec.whatwg.org/#dom-formdata */
+
+/** @implements {FormData} */
+export default class FormData {
+  /** @type {Map<string, (string|File)[]>} */
+  #list = new Map();
+
+  /** @param {HTMLFormElement} [form] */
+  constructor(form) {
+    if (form) {
+      throw new Error('InvalidStateError');
+    }
+  }
+
+  /**
+   * @param {string} s
+   * @return {string}
+   */
+  static #scalarValue = String;
+
+  /**
+   * @param {string} name
+   * @param {string|Blob} value
+   * @param {string} [filename]
+   * @return {{name:string, value:string|File}}
+   */
+  static #createEntry(name, value, filename) {
+    if (typeof value === 'string') {
+      return {
+        name: FormData.#scalarValue(name),
+        value: FormData.#scalarValue(value),
+      };
+    }
+
+    if (typeof File === 'undefined') {
+      if (!('name' in value) && !('lastModified' in value)) {
+        // eslint-disable-next-line unicorn/prefer-spread
+        const file = /** @type {File} */ (Object.defineProperties(value.slice(), {
+          name: {
+            value: filename === undefined ? 'blob' : filename,
+          },
+          lastModified: {
+            value: Date.now(),
+          },
+          webkitRelativePath: { value: '' },
+          toString: { value: () => '[object File]' },
+        }));
+        return {
+          name: FormData.#scalarValue(name),
+          value: file,
+        };
+      }
+      return {
+        name: FormData.#scalarValue(name),
+        // eslint-disable-next-line object-shorthand
+        value: /** @type {File} */ (value),
+      };
+    }
+    if (value instanceof File) {
+      return {
+        name: FormData.#scalarValue(name),
+        value,
+      };
+    }
+    return {
+      name: FormData.#scalarValue(name),
+      value: new File([value], filename === undefined ? 'blob' : filename, {}),
+    };
+  }
+
+  /**
+   * @param {string} name
+   * @param {string|Blob} value
+   * @param {string} [filename]
+   * @return {void}
+   */
+  append(name, value, filename) {
+    const entry = FormData.#createEntry(name, value, filename);
+    if (this.#list.has(entry.name)) {
+      this.#list.get(entry.name).push(entry.value);
+    } else {
+      this.#list.set(name, [entry.value]);
+    }
+  }
+
+  /**
+   * @param {string} name
+   * @return {void}
+   */
+  delete(name) {
+    this.#list.delete(name);
+  }
+
+  /**
+   * @param {string} name
+   * @return {null|File|string}
+   */
+  get(name) {
+    const entry = this.#list.get(name);
+    if (!entry) return null;
+    return entry[0];
+  }
+
+  /**
+   * @param {string} name
+   * @return {(File|string)[]}
+   */
+  getAll(name) {
+    return this.#list.get(name) ?? [];
+  }
+
+  /**
+   * @param {string} name
+   * @return {boolean}
+   */
+  has(name) {
+    return this.#list.has(name);
+  }
+
+  /**
+   * @param {string} name
+   * @param {string|Blob} value
+   * @param {string} [filename]
+   * @return {void}
+   */
+  set(name, value, filename) {
+    const entry = FormData.#createEntry(name, value, filename);
+    if (this.#list.has(entry.name)) {
+      const entries = this.#list.get(name);
+      entries.splice(0, entries.length, entry.value);
+    } else {
+      this.#list.set(name, [entry.value]);
+    }
+  }
+
+  /**
+   * @param {(value:(string|File), key:string, parent:this) => void} callback
+   * @return {void}
+   */
+  forEach(callback) {
+    for (const [key, value] of this) {
+      callback(value, key, this);
+    }
+  }
+
+  get keys() {
+    return this.#list.keys;
+  }
+
+  * values() {
+    for (const value of this.#list.values()) {
+      yield value[0];
+    }
+  }
+
+  * [Symbol.iterator]() {
+    for (const entry of this.#list.entries()) {
+      yield /** @type {[string, string|File]} */ ([entry[0], entry[1][0]]);
+    }
+  }
+}
+
+FormData.prototype.entries = FormData.prototype[Symbol.iterator];
+FormData.prototype.toString = () => '[Object FormData]';

package/types/middleware/ReadFormData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReadFormData.d.ts","sourceRoot":"","sources":["../../middleware/ReadFormData.js"],"names":[],"mappings":"AAwFA;;IAEI,aAA8C;CAQjD;0BAlGa,OAAO,uBAAuB,EAAE,OAAO;iCACvC,OAAO,yBAAyB,EAAE,kBAAkB"}
+{"version":3,"file":"ReadFormData.d.ts","sourceRoot":"","sources":["../../middleware/ReadFormData.js"],"names":[],"mappings":"AA2FA;;IAEI,aAA8C;CAQjD;0BArGa,OAAO,uBAAuB,EAAE,OAAO;iCACvC,OAAO,yBAAyB,EAAE,kBAAkB"}

package/types/middleware/SendJsonMiddleware.d.ts

@@ -12,7 +12,7 @@
  */
 export default class SendJsonMiddleware {
     /** @type {SendJsonMiddleware} */
-    static "__#5@#defaultInstance": SendJsonMiddleware;
+    static "__#private@#defaultInstance": SendJsonMiddleware;
     /**
      * @param {string} charset
      * @return {BufferEncoding}

package/types/middleware/SendJsonMiddleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SendJsonMiddleware.d.ts","sourceRoot":"","sources":["../../middleware/SendJsonMiddleware.js"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yGAAyG;AACzG,yFAAyF;AACzF,uFAAuF;AAEvF;;;;;;;GAOG;AAIH;IACE,iCAAiC;IACjC,gCADW,kBAAkB,CACL;IAExB;;;OAGG;IACH,wCAHW,MAAM,GACL,cAAc,CAsBzB;;;;IAcD,mDAAmD;IACnD,sBADY,yBAAyB,EASpC;IAPC;;;;MAIC;;;;;CAkEJ;0BAlIa,OAAO,yBAAyB,EAAE,WAAW;yCAC7C,OAAO,yBAAyB,EAAE,0BAA0B;iCAC5D,OAAO,yBAAyB,EAAE,kBAAkB;gCACpD,OAAO,yBAAyB,EAAE,iBAAiB;;qBAIvD,MAAM;;;;iBACN,OAAO;;;;mBAEP,OAAO"}
+{"version":3,"file":"SendJsonMiddleware.d.ts","sourceRoot":"","sources":["../../middleware/SendJsonMiddleware.js"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yGAAyG;AACzG,yFAAyF;AACzF,uFAAuF;AAEvF;;;;;;;GAOG;AAIH;IACE,iCAAiC;IACjC,sCADW,kBAAkB,CACL;IAExB;;;OAGG;IACH,wCAHW,MAAM,GACL,cAAc,CAsBzB;;;;IAcD,mDAAmD;IACnD,sBADY,yBAAyB,EASpC;IAPC;;;;MAIC;;;;;CAkEJ;0BAlIa,OAAO,yBAAyB,EAAE,WAAW;yCAC7C,OAAO,yBAAyB,EAAE,0BAA0B;iCAC5D,OAAO,yBAAyB,EAAE,kBAAkB;gCACpD,OAAO,yBAAyB,EAAE,iBAAiB;;qBAIvD,MAAM;;;;iBACN,OAAO;;;;mBAEP,OAAO"}

package/types/polyfill/FormData.d.ts

@@ -0,0 +1,66 @@
+/** @implements {FormData} */
+export default class FormData implements FormData {
+    /**
+     * @param {string} s
+     * @return {string}
+     */
+    static "__#private@#scalarValue": StringConstructor;
+    /**
+     * @param {string} name
+     * @param {string|Blob} value
+     * @param {string} [filename]
+     * @return {{name:string, value:string|File}}
+     */
+    static "__#private@#createEntry"(name: string, value: string | Blob, filename?: string): {
+        name: string;
+        value: string | File;
+    };
+    /** @param {HTMLFormElement} [form] */
+    constructor(form?: HTMLFormElement);
+    /**
+     * @param {string} name
+     * @param {string|Blob} value
+     * @param {string} [filename]
+     * @return {void}
+     */
+    append(name: string, value: string | Blob, filename?: string): void;
+    /**
+     * @param {string} name
+     * @return {void}
+     */
+    delete(name: string): void;
+    /**
+     * @param {string} name
+     * @return {null|File|string}
+     */
+    get(name: string): null | File | string;
+    /**
+     * @param {string} name
+     * @return {(File|string)[]}
+     */
+    getAll(name: string): (File | string)[];
+    /**
+     * @param {string} name
+     * @return {boolean}
+     */
+    has(name: string): boolean;
+    /**
+     * @param {string} name
+     * @param {string|Blob} value
+     * @param {string} [filename]
+     * @return {void}
+     */
+    set(name: string, value: string | Blob, filename?: string): void;
+    /**
+     * @param {(value:(string|File), key:string, parent:this) => void} callback
+     * @return {void}
+     */
+    forEach(callback: (value: (string | File), key: string, parent: this) => void): void;
+    get keys(): () => MapIterator<string>;
+    values(): Generator<string | File, void, unknown>;
+    entries: () => Generator<[string, string | File], void, unknown>;
+    toString(): string;
+    [Symbol.iterator](): Generator<[string, string | File], void, unknown>;
+    #private;
+}
+//# sourceMappingURL=FormData.d.ts.map

package/types/polyfill/FormData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormData.d.ts","sourceRoot":"","sources":["../../polyfill/FormData.js"],"names":[],"mappings":"AAEA,6BAA6B;AAC7B,yCADiB,QAAQ;IAYvB;;;OAGG;IACH,oDAA6B;IAE7B;;;;;OAKG;IACH,uCALW,MAAM,SACN,MAAM,GAAC,IAAI,aACX,MAAM,GACL;QAAC,IAAI,EAAC,MAAM,CAAC;QAAC,KAAK,EAAC,MAAM,GAAC,IAAI,CAAA;KAAC,CA4C3C;IA7DD,sCAAsC;IACtC,mBADY,eAAe,EAK1B;IA0DD;;;;;OAKG;IACH,aALW,MAAM,SACN,MAAM,GAAC,IAAI,aACX,MAAM,GACL,IAAI,CASf;IAED;;;OAGG;IACH,aAHW,MAAM,GACL,IAAI,CAIf;IAED;;;OAGG;IACH,UAHW,MAAM,GACL,IAAI,GAAC,IAAI,GAAC,MAAM,CAM3B;IAED;;;OAGG;IACH,aAHW,MAAM,GACL,CAAC,IAAI,GAAC,MAAM,CAAC,EAAE,CAI1B;IAED;;;OAGG;IACH,UAHW,MAAM,GACL,OAAO,CAIlB;IAED;;;;;OAKG;IACH,UALW,MAAM,SACN,MAAM,GAAC,IAAI,aACX,MAAM,GACL,IAAI,CAUf;IAED;;;OAGG;IACH,kBAHW,CAAC,KAAK,EAAC,CAAC,MAAM,GAAC,IAAI,CAAC,EAAE,GAAG,EAAC,MAAM,EAAE,MAAM,EAAC,IAAI,KAAK,IAAI,GACrD,IAAI,CAMf;IAED,sCAEC;IAED,kDAIC;IASH,iEAA0B;IAC1B,mBAAuD;IARrD,uEAIC;;CACF"}