Updates for new standard

Author: alpheusmtx

.github/dependabot.yml

@@ -10,7 +10,7 @@ updates:
           - dependency-name: "@apst/biome"
           - dependency-name: "@apst/tsconfig"
           - dependency-name: "@biomejs/biome"
-          - dependency-name: "tsup"
+          - dependency-name: "tsdown"
           - dependency-name: "typedoc"
           - dependency-name: "typedoc-plugin-markdown"
           - dependency-name: "typescript"

README.md

@@ -2,7 +2,7 @@
 
 A response builder for JavaScript / TypeScript.
 
-This package includes different response builders based on the JSON response structure specified in [JSON Data Error Response (JDER)](https://github.com/jder-std/spec). With the builders, various kinds of responses can be created easily instead of sending plain text responses.
+This package includes different response builders based on the JSON response structure specified in [JSON Data Errors Response (JDER)](https://github.com/jder-std/spec). With the builders, various kinds of responses can be created easily instead of sending plain text responses.
 
 ## Installation
 

docs/README.md

@@ -79,9 +79,11 @@ import { createJsonResponse } from "@jderjs/core";
 
 const route = (): Response => {
     return createJsonResponse({
-        error: {
-            code: "server",
-        },
+        errors: [
+            {
+                code: "server",
+            },
+        ],
     });
 }
 ```
@@ -91,9 +93,11 @@ And the response will be shown as below:
 ```json
 {
     "success": false,
-    "error": {
-        "code": "server"
-    }
+    "errors": [
+        {
+            "code": "server"
+        }
+    ]
 }
 ```
 

package.json

@@ -4,7 +4,7 @@
         "@apst/biome": "~0.3.0",
         "@apst/tsconfig": "~0.1.3",
         "@biomejs/biome": "^2.1.4",
-        "tsdown": "~0.13.0",
+        "tsdown": "~0.14.1",
         "typedoc": "~0.28.10",
         "typedoc-plugin-markdown": "^4.8.1",
         "typescript": "^5.9.2"

package/CHANGELOG.md

@@ -1,3 +1,34 @@
+## 0.3.0
+
+### Breaking Changes
+
+- Support new standard
+
+### Migrating from 0.2.0 to 0.3.0
+
+```diff
+import {
+    createJsonResponse,
+} from "@jderjs/core";
+
+const route = (): Response => {
+    return createJsonResponse({
+-       error: {
+-           code: "parse",
+-           field: "title",
+-           message: "Invalid title",
+-       },
++       errors: [
++           {
++               code: "parse",
++               path: ["json", "title"],
++               message: "Invalid title",
++           }
++       ],
+    });
+}
+```
+
 ## 0.2.0 (2025-08-06)
 
 ### What's Changed

package/README.md

@@ -2,7 +2,7 @@
 
 A standard response builder.
 
-This package includes different response builders based on the JSON response structure specified in [JSON Data Error Response (JDER)](https://github.com/jder-std/spec). With the builders, various kinds of responses can be created easily instead of sending plain text responses.
+This package includes different response builders based on the JSON response structure specified in [JSON Data Errors Response (JDER)](https://github.com/jder-std/spec). With the builders, various kinds of responses can be created easily instead of sending plain text responses.
 
 ## Quick Start
 

package/src/@types/response.ts

@@ -6,22 +6,22 @@ type HeaderTuple = [
 
 /** JSON response error. */
 type JsonResponseError = {
-    /** Error code. */
+    /** Code representing the error. */
     code: string;
-    /** Field of the error. */
-    field?: string;
-    /** Message of the error. */
+    /** Indicates where the error occurred. */
+    path?: string[];
+    /** Detail of the error. */
     message?: string;
 };
 
 /** JSON response. */
 type JsonResponse<D = unknown> = {
-    /** Whether the response is successful. */
+    /** Indicates whether the response is successful or not. */
     success: boolean;
-    /** Data for the response when `success` is `true`. */
+    /** Requested information for the response when `success` is `true`. */
     data?: D;
-    /** Error for the response when `success` is `false`. */
-    error?: JsonResponseError;
+    /** A list of errors for the response when `success` is `false`. */
+    errors?: JsonResponseError[];
 };
 
 export type { HeaderTuple, JsonResponseError, JsonResponse };

package/src/response/json/index.ts

@@ -40,10 +40,13 @@ type CreateJsonResponseOptions<D = unknown> =
  *
  * const route = (): Response => {
  *     return createJsonResponse({
- *         error: {
- *             code: "server",
- *             message: "Internal server error",
- *         },
+ *         status: 500,
+ *         errors: [
+ *             {
+ *                 code: "server",
+ *                 message: "Internal server error",
+ *             },
+ *         ],
  *     });
  * };
  * ```

package/src/response/json/struct.ts

@@ -28,9 +28,9 @@ type CreateJsonSuccessResponseStructOptions<D = unknown> = {
      */
     data?: D;
     /**
-     * Error for the response when `success` is `false`.
+     * A list of errors for the response when `success` is `false`.
      */
-    error?: never;
+    errors?: never;
 };
 
 type CreateJsonFailureResponseStructOptions = {
@@ -53,9 +53,9 @@ type CreateJsonFailureResponseStructOptions = {
      */
     data?: never;
     /**
-     * Error for the response when `success` is `false`.
+     * A list of errors for the response when `success` is `false`.
      */
-    error: JsonResponseError;
+    errors: JsonResponseError[];
 };
 
 /** Options of `createJsonResponseStruct` function. */
@@ -79,8 +79,8 @@ const isResponseSuccess = <D>(
 ): boolean => {
     // blank options
     if (!options) return true;
-    // error specified
-    if ("error" in options && typeof options.error === "object") return false;
+    // errors specified
+    if ("errors" in options && Array.isArray(options.errors)) return false;
     // default
     return true;
 };
@@ -111,7 +111,8 @@ const createJsonResponseStruct = <D = unknown>(
           }
         : {
               success: false,
-              error: (options as CreateJsonFailureResponseStructOptions).error,
+              errors: (options as CreateJsonFailureResponseStructOptions)
+                  .errors,
           };
 
     return {