@telorun/http-server 0.20.0 → 0.26.0

package/dist/http-server-controller.js

@@ -164,8 +164,35 @@ class HttpServer {
             }, { eventName: "http.server.request" });
         });
     }
+    /**
+     * Accept a multipart body out of the box.
+     *
+     * Fastify ships parsers for JSON and urlencoded and nothing else, so a route
+     * receiving a file upload answered 415 before any handler ran — a failure that
+     * names a media type the author DID send and points at no fix. Every server
+     * taking an upload had to discover `contentTypeParsers` first.
+     *
+     * Registered as RAW BYTES rather than a string, because that is what a
+     * multipart body is: decoding it as text corrupts every binary part, and the
+     * parts are the point. The handler receives the undrained request stream, which
+     * `Multipart.Decoder` consumes.
+     *
+     * Registered UNCONDITIONALLY, as a regex. Fastify keys a duplicate on the exact
+     * string (or the regex's `toString()`) and consults its string parsers before
+     * its regex ones, so a declared `multipart/form-data` neither collides with this
+     * nor is shadowed by it — it simply wins for its own type. Skipping the default
+     * whenever any multipart parser was declared would instead disable it for the
+     * SIBLING subtypes the author did not customize, so declaring a parser for
+     * `form-data` would silently restore the 415 for `related` and `mixed`.
+     */
+    installDefaultMultipartParser() {
+        this.app.addContentTypeParser(/^multipart\//, (_req, payload, done) => {
+            done(null, payload);
+        });
+    }
     async setupPlugins() {
         this.installRequestLogging();
+        this.installDefaultMultipartParser();
         for (const { contentType, parser, stream } of this.resource.contentTypeParsers ?? []) {
             if (stream) {
                 // Raw passthrough: omit `parseAs` so Fastify hands the handler the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/http-server",
-  "version": "0.20.0",
+  "version": "0.26.0",
   "description": "Telo HTTP Server module - HTTP server and API resource kinds for Telo manifests.",
   "keywords": [
     "telo",
@@ -49,13 +49,13 @@
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "fastify": "^5.7.2",
-    "@telorun/http-dispatch": "0.4.2"
+    "@telorun/http-dispatch": "0.11.1"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "typescript": "^5.0.0",
     "vitest": "^2.1.8",
-    "@telorun/sdk": "0.73.0"
+    "@telorun/sdk": "0.75.0"
   },
   "peerDependencies": {
     "@telorun/sdk": "*"

package/src/http-server-controller.ts

@@ -261,8 +261,36 @@ class HttpServer implements ResourceInstance {
     });
   }
 
+  /**
+   * Accept a multipart body out of the box.
+   *
+   * Fastify ships parsers for JSON and urlencoded and nothing else, so a route
+   * receiving a file upload answered 415 before any handler ran — a failure that
+   * names a media type the author DID send and points at no fix. Every server
+   * taking an upload had to discover `contentTypeParsers` first.
+   *
+   * Registered as RAW BYTES rather than a string, because that is what a
+   * multipart body is: decoding it as text corrupts every binary part, and the
+   * parts are the point. The handler receives the undrained request stream, which
+   * `Multipart.Decoder` consumes.
+   *
+   * Registered UNCONDITIONALLY, as a regex. Fastify keys a duplicate on the exact
+   * string (or the regex's `toString()`) and consults its string parsers before
+   * its regex ones, so a declared `multipart/form-data` neither collides with this
+   * nor is shadowed by it — it simply wins for its own type. Skipping the default
+   * whenever any multipart parser was declared would instead disable it for the
+   * SIBLING subtypes the author did not customize, so declaring a parser for
+   * `form-data` would silently restore the 415 for `related` and `mixed`.
+   */
+  private installDefaultMultipartParser(): void {
+    this.app.addContentTypeParser(/^multipart\//, (_req, payload, done) => {
+      done(null, payload);
+    });
+  }
+
   private async setupPlugins() {
     this.installRequestLogging();
+    this.installDefaultMultipartParser();
     for (const { contentType, parser, stream } of this.resource.contentTypeParsers ?? []) {
       if (stream) {
         // Raw passthrough: omit `parseAs` so Fastify hands the handler the