Migrate to tsdown and update internal APIs

Author: alpheusmtx

.ls-lint.yml

@@ -15,6 +15,7 @@ ignore:
     - dist
     - "**/dist"
     - apis
+    - "**/@types"
     - "*.tsbuildinfo"
     - "**/*.tsbuildinfo"
     - "**/*.log"

justfile

@@ -4,7 +4,7 @@ set windows-shell := ["powershell"]
 node_bin := "./node_modules/.bin/"
 tsc := node_bin + "tsc"
 biome := node_bin + "biome"
-tsup := node_bin + "tsup"
+tsdown := node_bin + "tsdown"
 vitest := node_bin + "vitest"
 typedoc := node_bin + "typedoc"
 
@@ -36,7 +36,7 @@ fmt:
 
 # Build package
 build:
-    cd package && ../{{tsup}}
+    cd package && ../{{tsdown}} -c tsdown.config.ts
 
 # Run tests
 test:

package.json

@@ -4,7 +4,7 @@
         "@apst/biome": "~0.3.0",
         "@apst/tsconfig": "~0.1.3",
         "@biomejs/biome": "^2.1.2",
-        "tsup": "^8.5.0",
+        "tsdown": "~0.13.0",
         "typedoc": "~0.28.7",
         "typedoc-plugin-markdown": "^4.7.1",
         "typescript": "^5.8.3"

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## Next
+
+### What's Changed
+
+- Internal API changes
+
 ## 0.1.3 (2025-06-12)
 
 ### What's Changed

package/package.json

@@ -29,10 +29,20 @@
             "import": "./dist/index.mjs",
             "require": "./dist/index.js"
         },
-        "./internal": {
-            "types": "./dist/internal.d.ts",
-            "import": "./dist/internal.mjs",
-            "require": "./dist/internal.js"
+        "./response/common/struct": {
+            "types": "./dist/response/common/struct.d.ts",
+            "import": "./dist/response/common/struct.mjs",
+            "require": "./dist/response/common/struct.js"
+        },
+        "./response/json/struct": {
+            "types": "./dist/response/json/struct.d.ts",
+            "import": "./dist/response/json/struct.mjs",
+            "require": "./dist/response/json/struct.js"
+        },
+        "./response/headers/merge": {
+            "types": "./dist/response/headers/merge.d.ts",
+            "import": "./dist/response/headers/merge.mjs",
+            "require": "./dist/response/headers/merge.js"
         },
         "./package.json": "./package.json"
     },

package/src/@types/response.ts

@@ -0,0 +1,21 @@
+/** JSON response error. */
+type JsonResponseError = {
+    /** Error code. */
+    code: string;
+    /** Field of the error. */
+    field?: string;
+    /** Message of the error. */
+    message?: string;
+};
+
+/** JSON response. */
+type JsonResponse<D = unknown> = {
+    /** Whether the response is successful. */
+    success: boolean;
+    /** Data for the response when `success` is `true`. */
+    data?: D;
+    /** Error for the response when `success` is `false`. */
+    error?: JsonResponseError;
+};
+
+export type { JsonResponseError, JsonResponse };

package/src/index.ts

@@ -1,9 +1,9 @@
-export type { CreateResponseOptions } from "#/response";
 export type {
-    CreateJsonResponseOptions,
     JsonResponse,
     JsonResponseError,
-} from "#/response/json";
+} from "#/@types/response";
+export type { CreateResponseOptions } from "#/response/common";
+export type { CreateJsonResponseOptions } from "#/response/json";
 
-export { createResponse } from "#/response";
+export { createResponse } from "#/response/common";
 export { createJsonResponse } from "#/response/json";

package/src/internal.ts

@@ -0,0 +1,52 @@
+import type { CreateResponseStructOptions } from "#/response/common/struct";
+
+import { createResponseStruct } from "#/response/common/struct";
+
+/** Options of `createResponse` function. */
+type CreateResponseOptions<B extends BodyInit = BodyInit> =
+    CreateResponseStructOptions<B>;
+
+/**
+ * Create a response.
+ *
+ * ### Examples
+ *
+ * Example for creating a basic response:
+ *
+ * ```ts
+ * import { createResponse } from "@jderjs/core";
+ *
+ * const route = (): Response => {
+ *     return createResponse();
+ * };
+ * ```
+ *
+ * Example for creating a response with status, headers, and body:
+ *
+ * ```ts
+ * import { createResponse } from "@jderjs/core";
+ *
+ * const route = (): Response => {
+ *     return createResponse({
+ *         status: 404,
+ *         headers: [
+ *             ["Content-Type", "text/plain"],
+ *         ],
+ *         body: "Not Found",
+ *     });
+ * };
+ * ```
+ */
+const createResponse = <B extends BodyInit = BodyInit>(
+    options?: CreateResponseOptions<B>,
+): Response => {
+    const { status, headers, body } = createResponseStruct(options);
+
+    return new Response(body, {
+        status,
+        headers,
+    });
+};
+
+export type { CreateResponseOptions };
+export { createResponse };

package/src/response/common/index.ts

@@ -0,0 +1,43 @@
+import { mergeHeaders } from "#/response/headers/merge";
+
+type CreateResponseStructOptions<B extends BodyInit = BodyInit> = {
+    /**
+     * Status code of the response.
+     * By default, it is `200`.
+     */
+    status?: number;
+    /**
+     * Additional headers of the response.
+     */
+    headers?: HeadersInit;
+    /**
+     * Body of the response.
+     */
+    body?: B;
+};
+
+/** Response structure. */
+type ResponseStruct<B = unknown> = {
+    /** Status code of the response. */
+    status: number;
+    /** Headers of the response. */
+    headers: [
+        string,
+        string,
+    ][];
+    /** Body of the response. */
+    body?: B;
+};
+
+const createResponseStruct = <B extends BodyInit = BodyInit>(
+    options?: CreateResponseStructOptions<B>,
+): ResponseStruct<B> => {
+    return {
+        status: options?.status ?? 200,
+        headers: mergeHeaders(options?.headers),
+        body: options?.body,
+    };
+};
+
+export type { CreateResponseStructOptions, ResponseStruct };
+export { createResponseStruct };