hoa 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## v0.3.0 / 2025-10-16
+
+- feat: move respond() to ctx.response
+
+## v0.2.1 / 2025-10-15
+
+- fix: rename HoaExtend to HoaExtension
+
 ## v0.2.0 / 2025-10-12
 
 - refactor: rename Application to Hoa

package/dist/cjs/context.js

@@ -97,6 +97,70 @@ class HoaContext {
       headers: res._headers
     });
   }
+  /**
+   * Build Web Standard Response from current context state.
+   * Handles various body types, HEAD requests, and status-specific behaviors.
+   *
+   * @returns {Response} Web Standard Response object
+   * @public
+  */
+  get response() {
+    const { res, req } = this;
+    let body = res.body;
+    if (req.method === "HEAD") {
+      if (!res.has("Content-Length")) {
+        const contentLength = res.length;
+        if (Number.isInteger(contentLength)) {
+          res.length = contentLength;
+        }
+      }
+      return new Response(null, {
+        status: res.status,
+        statusText: res.statusText,
+        headers: res._headers
+      });
+    }
+    if (import_utils.statusEmptyMapping[res.status]) {
+      res.body = null;
+      return new Response(null, {
+        status: res.status,
+        statusText: res.statusText,
+        headers: res._headers
+      });
+    }
+    if (body == null) {
+      if (res._explicitNullBody) {
+        res.delete("Content-Type");
+        res.delete("Transfer-Encoding");
+        res.set("Content-Length", "0");
+      }
+      return new Response(null, {
+        status: res.status,
+        statusText: res.statusText,
+        headers: res._headers
+      });
+    }
+    if (typeof body === "string" || body instanceof Blob || body instanceof ArrayBuffer || ArrayBuffer.isView(body) || body instanceof ReadableStream || body instanceof FormData || body instanceof URLSearchParams) {
+      return new Response(body, {
+        status: res.status,
+        statusText: res.statusText,
+        headers: res._headers
+      });
+    }
+    if (body instanceof Response) {
+      return new Response(body.body, {
+        status: res.status,
+        statusText: res.statusText,
+        headers: res._headers
+      });
+    }
+    body = JSON.stringify(body);
+    return new Response(body, {
+      status: res.status,
+      statusText: res.statusText,
+      headers: res._headers
+    });
+  }
   /**
    * Return JSON representation of the context.
    *

package/dist/cjs/hoa.js

@@ -38,7 +38,6 @@ __export(hoa_exports, {
 module.exports = __toCommonJS(hoa_exports);
 var import_compose = __toESM(require("./lib/compose.js"), 1);
 var import_http_error = __toESM(require("./lib/http-error.js"), 1);
-var import_utils = require("./lib/utils.js");
 var import_context = __toESM(require("./context.js"), 1);
 var import_request = __toESM(require("./request.js"), 1);
 var import_response = __toESM(require("./response.js"), 1);
@@ -60,7 +59,7 @@ class Hoa {
   /**
    * Extend the application with a plugin initializer.
    *
-   * @param {HoaExtend} fn - Plugin function that receives the app instance
+   * @param {HoaExtension} fn - Plugin function that receives the app instance
    * @returns {Hoa} The Hoa instance for method chaining
    * @throws {TypeError}
    * @public
@@ -113,9 +112,7 @@ class Hoa {
    * @private
    */
   handleRequest(ctx, middlewareFn) {
-    const onerror = (err) => ctx.onerror(err);
-    const handleResponse = () => respond(ctx);
-    return middlewareFn(ctx).then(handleResponse).catch(onerror);
+    return middlewareFn(ctx).then(() => ctx.response).catch((err) => ctx.onerror(err));
   }
   /**
    * Create context for incoming request with linked request/response objects.
@@ -180,63 +177,6 @@ ${msg.replace(/^/gm, "  ")}
     };
   }
 }
-function respond(ctx) {
-  const { res, req } = ctx;
-  let body = res.body;
-  if (req.method === "HEAD") {
-    if (!res.has("Content-Length")) {
-      const contentLength = res.length;
-      if (Number.isInteger(contentLength)) {
-        res.length = contentLength;
-      }
-    }
-    return new Response(null, {
-      status: res.status,
-      statusText: res.statusText,
-      headers: res._headers
-    });
-  }
-  if (import_utils.statusEmptyMapping[res.status]) {
-    res.body = null;
-    return new Response(null, {
-      status: res.status,
-      statusText: res.statusText,
-      headers: res._headers
-    });
-  }
-  if (body == null) {
-    if (res._explicitNullBody) {
-      res.delete("Content-Type");
-      res.delete("Transfer-Encoding");
-      res.set("Content-Length", "0");
-    }
-    return new Response(null, {
-      status: res.status,
-      statusText: res.statusText,
-      headers: res._headers
-    });
-  }
-  if (typeof body === "string" || body instanceof Blob || body instanceof ArrayBuffer || ArrayBuffer.isView(body) || body instanceof ReadableStream || body instanceof FormData || body instanceof URLSearchParams) {
-    return new Response(body, {
-      status: res.status,
-      statusText: res.statusText,
-      headers: res._headers
-    });
-  }
-  if (body instanceof Response) {
-    return new Response(body.body, {
-      status: res.status,
-      statusText: res.statusText,
-      headers: res._headers
-    });
-  }
-  body = JSON.stringify(body);
-  return new Response(body, {
-    status: res.status,
-    statusText: res.statusText,
-    headers: res._headers
-  });
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Hoa,

package/dist/esm/context.js

@@ -1,5 +1,5 @@
 import HttpError from "./lib/http-error.js";
-import { statusTextMapping } from "./lib/utils.js";
+import { statusTextMapping, statusEmptyMapping } from "./lib/utils.js";
 class HoaContext {
   /**
    * Create a context for a single HTTP request.
@@ -65,6 +65,70 @@ class HoaContext {
       headers: res._headers
     });
   }
+  /**
+   * Build Web Standard Response from current context state.
+   * Handles various body types, HEAD requests, and status-specific behaviors.
+   *
+   * @returns {Response} Web Standard Response object
+   * @public
+  */
+  get response() {
+    const { res, req } = this;
+    let body = res.body;
+    if (req.method === "HEAD") {
+      if (!res.has("Content-Length")) {
+        const contentLength = res.length;
+        if (Number.isInteger(contentLength)) {
+          res.length = contentLength;
+        }
+      }
+      return new Response(null, {
+        status: res.status,
+        statusText: res.statusText,
+        headers: res._headers
+      });
+    }
+    if (statusEmptyMapping[res.status]) {
+      res.body = null;
+      return new Response(null, {
+        status: res.status,
+        statusText: res.statusText,
+        headers: res._headers
+      });
+    }
+    if (body == null) {
+      if (res._explicitNullBody) {
+        res.delete("Content-Type");
+        res.delete("Transfer-Encoding");
+        res.set("Content-Length", "0");
+      }
+      return new Response(null, {
+        status: res.status,
+        statusText: res.statusText,
+        headers: res._headers
+      });
+    }
+    if (typeof body === "string" || body instanceof Blob || body instanceof ArrayBuffer || ArrayBuffer.isView(body) || body instanceof ReadableStream || body instanceof FormData || body instanceof URLSearchParams) {
+      return new Response(body, {
+        status: res.status,
+        statusText: res.statusText,
+        headers: res._headers
+      });
+    }
+    if (body instanceof Response) {
+      return new Response(body.body, {
+        status: res.status,
+        statusText: res.statusText,
+        headers: res._headers
+      });
+    }
+    body = JSON.stringify(body);
+    return new Response(body, {
+      status: res.status,
+      statusText: res.statusText,
+      headers: res._headers
+    });
+  }
   /**
    * Return JSON representation of the context.
    *

package/dist/esm/hoa.js

@@ -1,6 +1,5 @@
 import compose from "./lib/compose.js";
 import HttpError from "./lib/http-error.js";
-import { statusEmptyMapping } from "./lib/utils.js";
 import HoaContext from "./context.js";
 import HoaRequest from "./request.js";
 import HoaResponse from "./response.js";
@@ -22,7 +21,7 @@ class Hoa {
   /**
    * Extend the application with a plugin initializer.
    *
-   * @param {HoaExtend} fn - Plugin function that receives the app instance
+   * @param {HoaExtension} fn - Plugin function that receives the app instance
    * @returns {Hoa} The Hoa instance for method chaining
    * @throws {TypeError}
    * @public
@@ -75,9 +74,7 @@ class Hoa {
    * @private
    */
   handleRequest(ctx, middlewareFn) {
-    const onerror = (err) => ctx.onerror(err);
-    const handleResponse = () => respond(ctx);
-    return middlewareFn(ctx).then(handleResponse).catch(onerror);
+    return middlewareFn(ctx).then(() => ctx.response).catch((err) => ctx.onerror(err));
   }
   /**
    * Create context for incoming request with linked request/response objects.
@@ -142,63 +139,6 @@ ${msg.replace(/^/gm, "  ")}
     };
   }
 }
-function respond(ctx) {
-  const { res, req } = ctx;
-  let body = res.body;
-  if (req.method === "HEAD") {
-    if (!res.has("Content-Length")) {
-      const contentLength = res.length;
-      if (Number.isInteger(contentLength)) {
-        res.length = contentLength;
-      }
-    }
-    return new Response(null, {
-      status: res.status,
-      statusText: res.statusText,
-      headers: res._headers
-    });
-  }
-  if (statusEmptyMapping[res.status]) {
-    res.body = null;
-    return new Response(null, {
-      status: res.status,
-      statusText: res.statusText,
-      headers: res._headers
-    });
-  }
-  if (body == null) {
-    if (res._explicitNullBody) {
-      res.delete("Content-Type");
-      res.delete("Transfer-Encoding");
-      res.set("Content-Length", "0");
-    }
-    return new Response(null, {
-      status: res.status,
-      statusText: res.statusText,
-      headers: res._headers
-    });
-  }
-  if (typeof body === "string" || body instanceof Blob || body instanceof ArrayBuffer || ArrayBuffer.isView(body) || body instanceof ReadableStream || body instanceof FormData || body instanceof URLSearchParams) {
-    return new Response(body, {
-      status: res.status,
-      statusText: res.statusText,
-      headers: res._headers
-    });
-  }
-  if (body instanceof Response) {
-    return new Response(body.body, {
-      status: res.status,
-      statusText: res.statusText,
-      headers: res._headers
-    });
-  }
-  body = JSON.stringify(body);
-  return new Response(body, {
-    status: res.status,
-    statusText: res.statusText,
-    headers: res._headers
-  });
-}
 export {
   Hoa,
   HoaContext,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hoa",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A minimal web framework built on Web Standards",
   "main": "./dist/cjs/hoa.js",
   "type": "module",

package/types/index.d.ts

@@ -20,7 +20,7 @@ interface ResJSON {
   headers: Record<string, string>;
 }
 
-export type HoaExtend = (app: Hoa) => void;
+export type HoaExtension = (app: Hoa) => void;
 
 export type HoaMiddleware = (ctx: HoaContext, next?: () => Promise<void>) => Promise<void> | void;
 
@@ -34,7 +34,7 @@ export declare class Hoa {
   readonly HoaResponse: typeof HoaResponse;
   readonly middlewares: HoaMiddleware[];
 
-  extend(fn: HoaExtend): this;
+  extend(fn: HoaExtension): this;
   use(fn: HoaMiddleware): this;
   fetch(request: Request, env?: any, executionCtx?: any): Promise<Response>;
   protected handleRequest(ctx: HoaContext, middlewareFn: HoaMiddleware): Promise<Response>;
@@ -58,6 +58,7 @@ export declare class HoaContext {
   assert<T>(value: T, status: number, message?: string | { message?: string; cause?: unknown; expose?: boolean; headers?: Headers | Record<string, string> | Iterable<readonly [string, string]> }, options?: { message?: string; cause?: unknown; expose?: boolean; headers?: Headers | Record<string, string> | Iterable<readonly [string, string]> }): asserts value is NonNullable<T>;
   onerror(err: unknown): Response;
   toJSON(): CtxJSON;
+  readonly response: Response;
 }
 
 export declare class HoaRequest {