hoa 0.3.1 → 0.3.3

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## v0.3.3 / 2025-12-03
+
+- fix: types improvements
+
+## v0.3.2 / 2025-11-09
+
+- fix: export statusTextMapping + statusRedirectMapping + statusEmptyMapping
+
 ## v0.3.1 / 2025-11-08
 
 - fix: app.onerror print original error

package/dist/cjs/hoa.js

@@ -33,11 +33,15 @@ __export(hoa_exports, {
   HoaResponse: () => import_response.default,
   HttpError: () => import_http_error.default,
   compose: () => import_compose.default,
-  default: () => Hoa
+  default: () => Hoa,
+  statusEmptyMapping: () => import_utils.statusEmptyMapping,
+  statusRedirectMapping: () => import_utils.statusRedirectMapping,
+  statusTextMapping: () => import_utils.statusTextMapping
 });
 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);
@@ -181,5 +185,8 @@ class Hoa {
   HoaRequest,
   HoaResponse,
   HttpError,
-  compose
+  compose,
+  statusEmptyMapping,
+  statusRedirectMapping,
+  statusTextMapping
 });

package/dist/cjs/response.js

@@ -325,10 +325,10 @@ class HoaResponse {
    * @param {string} type - The content type or alias (e.g., 'json', 'html', 'application/json')
    * @public
    */
-  set type(type) {
-    if (!type) return;
-    type = import_utils.commonTypeMapping[type] || type;
-    this.set("Content-Type", type);
+  set type(val) {
+    if (!val) return;
+    val = import_utils.commonTypeMapping[val] || val;
+    this.set("Content-Type", val);
   }
   /**
    * Get the response Content-Length as a number.

package/dist/esm/hoa.js

@@ -1,5 +1,6 @@
 import compose from "./lib/compose.js";
 import HttpError from "./lib/http-error.js";
+import { statusTextMapping, statusRedirectMapping, statusEmptyMapping } from "./lib/utils.js";
 import HoaContext from "./context.js";
 import HoaRequest from "./request.js";
 import HoaResponse from "./response.js";
@@ -143,5 +144,8 @@ export {
   HoaResponse,
   HttpError,
   compose,
-  Hoa as default
+  Hoa as default,
+  statusEmptyMapping,
+  statusRedirectMapping,
+  statusTextMapping
 };

package/dist/esm/response.js

@@ -303,10 +303,10 @@ class HoaResponse {
    * @param {string} type - The content type or alias (e.g., 'json', 'html', 'application/json')
    * @public
    */
-  set type(type) {
-    if (!type) return;
-    type = commonTypeMapping[type] || type;
-    this.set("Content-Type", type);
+  set type(val) {
+    if (!val) return;
+    val = commonTypeMapping[val] || val;
+    this.set("Content-Type", val);
   }
   /**
    * Get the response Content-Length as a number.

package/package.json

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

package/types/index.d.ts

@@ -1,25 +1,32 @@
-interface AppJSON {
+interface HoaAppJson {
   name: string;
 }
 
-interface CtxJSON {
-  app: AppJSON;
-  req: ReqJSON;
-  res: ResJSON;
+interface HoaContextJson {
+  app: HoaAppJson;
+  req: HoaRequestJson;
+  res: HoaResponseJson;
 }
 
-interface ReqJSON {
+interface HoaRequestJson {
   method: string;
   url: string;
   headers: Record<string, string>;
 }
 
-interface ResJSON {
+interface HoaResponseJson {
   status: number;
   statusText: string;
   headers: Record<string, string>;
 }
 
+interface HoaError {
+  message?: string;
+  cause?: unknown;
+  expose?: boolean;
+  headers?: Headers | Record<string, string> | Iterable<readonly [string, string]>;
+}
+
 export type HoaExtension = (app: Hoa) => void;
 
 export type HoaMiddleware = (ctx: HoaContext, next?: () => Promise<void>) => Promise<void> | void;
@@ -40,7 +47,7 @@ export declare class Hoa {
   protected handleRequest(ctx: HoaContext, middlewareFn: HoaMiddleware): Promise<Response>;
   protected createContext(request: Request, env?: any, executionCtx?: any): HoaContext;
   protected onerror(err: unknown, ctx?: HoaContext): void;
-  toJSON(): AppJSON;
+  toJSON(): HoaAppJson;
 
   static get default(): typeof Hoa;
 }
@@ -54,10 +61,10 @@ export declare class HoaContext {
   env?: any;
   executionCtx?: any;
   state: Record<string, any>;
-  throw(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]> }): never;
-  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>;
+  throw(status: number, message?: string | HoaError, options?: HoaError): never;
+  assert<T>(value: T, status: number, message?: string | HoaError, options?: HoaError): asserts value is NonNullable<T>;
   onerror(err: unknown): Response;
-  toJSON(): CtxJSON;
+  toJSON(): HoaContextJson;
   readonly response: Response;
 }
 
@@ -67,54 +74,54 @@ export declare class HoaRequest {
   res: HoaResponse;
 
   get url(): URL;
-  set url(value: string | URL);
+  set url(val: string | URL);
 
   get href(): string;
-  set href(value: string);
+  set href(val: string);
 
   get origin(): string;
-  set origin(value: string);
+  set origin(val: string);
 
   get protocol(): string;
-  set protocol(value: string);
+  set protocol(val: string);
 
   get host(): string;
-  set host(value: string);
+  set host(val: string);
 
   get hostname(): string;
-  set hostname(value: string);
+  set hostname(val: string);
 
   get port(): string;
-  set port(value: string);
+  set port(val: string);
 
   get pathname(): string;
-  set pathname(value: string);
+  set pathname(val: string);
 
   get search(): string;
-  set search(value: string);
+  set search(val: string);
 
   get hash(): string;
-  set hash(value: string);
+  set hash(val: string);
 
   get method(): string;
-  set method(value: string);
+  set method(val: string);
 
   get query(): Record<string, string | string[]>;
-  set query(value: Record<string, string | string[]>);
+  set query(val: Record<string, string | string[]>);
 
   get headers(): Record<string, string>;
-  set headers(value: Headers | Record<string, string> | Iterable<readonly [string, string]>);
+  set headers(val: Headers | Record<string, string> | Iterable<readonly [string, string]>);
 
   get body(): ReadableStream<Uint8Array> | null;
-  set body(value: any);
+  set body(val: any);
 
   get(field: string): string | null;
   getSetCookie(): string[];
   has(field: string): boolean;
-  set(field: string, value: string): void;
-  set(values: Record<string, string>): void;
-  append(field: string, value: string): void;
-  append(values: Record<string, string>): void;
+  set(field: string, val: string): void;
+  set(field: Record<string, string>): void;
+  append(field: string, val: string): void;
+  append(field: Record<string, string>): void;
   delete(field: string): void;
 
   get ips(): string[];
@@ -129,10 +136,10 @@ export declare class HoaRequest {
   text(): Promise<string>;
   json<T = any>(): Promise<T>;
   formData(): Promise<FormData>;
-  toJSON(): ReqJSON;
+  toJSON(): HoaRequestJson;
 }
 
-type ResponseBody =
+type HoaResponseBody =
   | string
   | Blob
   | ArrayBuffer
@@ -151,43 +158,43 @@ export declare class HoaResponse {
   req: HoaRequest;
 
   get headers(): Record<string, string>;
-  set headers(value: Headers | Record<string, string> | Iterable<readonly [string, string]>);
+  set headers(val: Headers | Record<string, string> | Iterable<readonly [string, string]>);
 
   get(field: string): string | null;
   getSetCookie(): string[];
   has(field: string): boolean;
-  set(field: string, value: string): void;
-  set(values: Record<string, string>): void;
-  append(field: string, value: string): void;
-  append(values: Record<string, string>): void;
+  set(field: string, val: string): void;
+  set(field: Record<string, string>): void;
+  append(field: string, val: string): void;
+  append(field: Record<string, string>): void;
   delete(field: string): void;
 
   get status(): number;
-  set status(value: number);
+  set status(val: number);
 
   get statusText(): string;
-  set statusText(value: string);
+  set statusText(val: string);
 
-  get body(): ResponseBody;
-  set body(value: ResponseBody);
+  get body(): HoaResponseBody;
+  set body(val: HoaResponseBody);
 
   redirect(url: string): void;
   back(alt?: string): void;
 
   get type(): string | null;
-  set type(value: string);
+  set type(val: string);
 
   get length(): number | null;
-  set length(value: number | string);
+  set length(val: number | string);
 
-  toJSON(): ResJSON;
+  toJSON(): HoaResponseJson;
 }
 
 export declare class HttpError extends Error {
   constructor(
     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]> }
+    message?: string | HoaError,
+    options?: HoaError
   );
   readonly name: string;
   readonly status: number;