resora 1.1.0 → 1.2.0

package/README.md

@@ -33,6 +33,7 @@ Resora introduces a dedicated **response transformation layer** that removes the
 - Explicit data-to-response transformation
 - Automatic JSON response dispatch
 - First-class collection support
+- Nested resource and collection composition
 - Built-in pagination metadata handling
 - Built-in cursor metadata handling
 - Conditional attribute helpers (`when`, `whenNotNull`, `mergeWhen`)
@@ -134,7 +135,57 @@ Response:
 }
 ```
 
----
+### Nested Resources and Collections
+
+```ts
+import { Resource, ResourceCollection } from 'resora';
+
+class FamilyMemberResource extends Resource {
+  data() {
+    return {
+      id: this.id,
+      fullName: `${this.firstName} ${this.lastName}`,
+    };
+  }
+}
+
+class FamilyMemberCollection extends ResourceCollection {
+  collects = FamilyMemberResource;
+
+  data() {
+    return this.toObject();
+  }
+}
+
+class FamilyOverviewResource extends Resource {
+  data() {
+    return {
+      id: this.id,
+      familyName: this.familyName,
+      members: new FamilyMemberCollection(this.members ?? []),
+    };
+  }
+}
+```
+
+Response:
+
+```json
+{
+  "data": {
+    "id": 1,
+    "familyName": "Smiths",
+    "members": [
+      {
+        "id": 1,
+        "fullName": "Jane Doe"
+      }
+    ]
+  }
+}
+```
+
+You can also call `.toObject()` explicitly when you want the transformed collection array immediately inside a parent resource.
 
 ## Architectural Positioning
 
@@ -160,8 +211,6 @@ This separation ensures:
 - Strong typing as a first-class feature
 - Framework independence
 
----
-
 ## Framework Compatibility
 
 Resora is not tied to a specific HTTP framework.
@@ -191,6 +240,10 @@ Plugins can:
 - inject framework integrations without core changes
 - register reusable transformation utilities
 
+Available plugins:
+
+- [`@resora/plugin-clear-router`](https://arkstack-hq.github.io/resora/plugins/clear-router.md)
+
 ## Conditional Rendering Example
 
 ```ts
@@ -208,8 +261,6 @@ class UserResource extends Resource {
 
 Falsy/null attributes are omitted from the final serialized payload.
 
----
-
 ## When to Use Resora
 
 Resora is a good fit if you:
@@ -221,8 +272,6 @@ Resora is a good fit if you:
 
 It is intentionally not opinionated about routing, validation, or persistence.
 
----
-
 ## Documentation
 
 - Getting Started: https://arkstack-hq.github.io/resora/guide/getting-started
@@ -230,8 +279,6 @@ It is intentionally not opinionated about routing, validation, or persistence.
 - Conditional Rendering: https://arkstack-hq.github.io/resora/guide/conditional-attributes
 - Pagination & Cursor Recipes: https://arkstack-hq.github.io/resora/guide/pagination-cursor-recipes
 
----
-
 ## License
 
 MIT

package/dist/index.cjs

@@ -358,6 +358,8 @@ const extractUrlFromRequest = (req) => {
 const extractResponseFromCtx = (ctx) => {
 	if (!ctx || typeof ctx !== "object") return;
 	const obj = ctx;
+	if (typeof obj.header === "function" && typeof obj.status === "function") return ctx;
+	if (typeof obj.set === "function" && "status" in obj && "body" in obj) return ctx;
 	if (obj.res && typeof obj.res === "object") return obj.res;
 	return ctx;
 };
@@ -1352,8 +1354,10 @@ var ServerResponse = class {
 	*/
 	#addHeader(key, value) {
 		this.headers[key] = value;
-		if ("headers" in this.response) this.response.headers.set(key, value);
+		if ("headers" in this.response && this.response.headers && typeof this.response.headers.set === "function") this.response.headers.set(key, value);
 		else if ("setHeader" in this.response) this.response.setHeader(key, value);
+		else if ("set" in this.response && typeof this.response.set === "function") this.response.set(key, value);
+		else if ("header" in this.response && typeof this.response.header === "function") this.response.header(key, value);
 	}
 	/**
 	* Dispatch the current body and apply any deferred transport state.
@@ -1375,9 +1379,10 @@ var ServerResponse = class {
 		this.headers = { ...beforeSend.headers };
 		if ("send" in this.response && typeof this.response.send === "function") {
 			if ("statusCode" in this.response) this.response.statusCode = this._status;
-			const sentResponse = this.response.send(this.body);
-			if (sentResponse && "status" in sentResponse && typeof sentResponse.status === "function") sentResponse.status(this._status);
-			else if ("status" in this.response && typeof this.response.status === "function") this.response.status(this._status);
+			if ("status" in this.response && typeof this.response.status === "function") this.response.status(this._status);
+			else if ("code" in this.response && typeof this.response.code === "function") this.response.code(this._status);
+			this.response.__resoraStatus = this._status;
+			this.response.send(this.body);
 			runPluginHook("afterSend", {
 				response: this,
 				rawResponse: this.response,
@@ -1387,7 +1392,14 @@ var ServerResponse = class {
 			});
 			return this.body;
 		}
-		if ("status" in this.response && typeof this.response.status !== "function") this.response.status = this._status;
+		if ("status" in this.response && typeof this.response.status === "function") {
+			this.response.status(this._status);
+			this.response.__resoraStatus = this._status;
+		} else if ("status" in this.response && typeof this.response.status !== "function") this.response.status = this._status;
+		if ("body" in this.response) {
+			this.response.body = this.body;
+			this.response.__resoraStatus = this._status;
+		}
 		runPluginHook("afterSend", {
 			response: this,
 			rawResponse: this.response,

package/dist/index.mjs

@@ -329,6 +329,8 @@ const extractUrlFromRequest = (req) => {
 const extractResponseFromCtx = (ctx) => {
 	if (!ctx || typeof ctx !== "object") return;
 	const obj = ctx;
+	if (typeof obj.header === "function" && typeof obj.status === "function") return ctx;
+	if (typeof obj.set === "function" && "status" in obj && "body" in obj) return ctx;
 	if (obj.res && typeof obj.res === "object") return obj.res;
 	return ctx;
 };
@@ -1323,8 +1325,10 @@ var ServerResponse = class {
 	*/
 	#addHeader(key, value) {
 		this.headers[key] = value;
-		if ("headers" in this.response) this.response.headers.set(key, value);
+		if ("headers" in this.response && this.response.headers && typeof this.response.headers.set === "function") this.response.headers.set(key, value);
 		else if ("setHeader" in this.response) this.response.setHeader(key, value);
+		else if ("set" in this.response && typeof this.response.set === "function") this.response.set(key, value);
+		else if ("header" in this.response && typeof this.response.header === "function") this.response.header(key, value);
 	}
 	/**
 	* Dispatch the current body and apply any deferred transport state.
@@ -1346,9 +1350,10 @@ var ServerResponse = class {
 		this.headers = { ...beforeSend.headers };
 		if ("send" in this.response && typeof this.response.send === "function") {
 			if ("statusCode" in this.response) this.response.statusCode = this._status;
-			const sentResponse = this.response.send(this.body);
-			if (sentResponse && "status" in sentResponse && typeof sentResponse.status === "function") sentResponse.status(this._status);
-			else if ("status" in this.response && typeof this.response.status === "function") this.response.status(this._status);
+			if ("status" in this.response && typeof this.response.status === "function") this.response.status(this._status);
+			else if ("code" in this.response && typeof this.response.code === "function") this.response.code(this._status);
+			this.response.__resoraStatus = this._status;
+			this.response.send(this.body);
 			runPluginHook("afterSend", {
 				response: this,
 				rawResponse: this.response,
@@ -1358,7 +1363,14 @@ var ServerResponse = class {
 			});
 			return this.body;
 		}
-		if ("status" in this.response && typeof this.response.status !== "function") this.response.status = this._status;
+		if ("status" in this.response && typeof this.response.status === "function") {
+			this.response.status(this._status);
+			this.response.__resoraStatus = this._status;
+		} else if ("status" in this.response && typeof this.response.status !== "function") this.response.status = this._status;
+		if ("body" in this.response) {
+			this.response.body = this.body;
+			this.response.__resoraStatus = this._status;
+		}
 		runPluginHook("afterSend", {
 			response: this,
 			rawResponse: this.response,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resora",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "A structured API response layer for Node.js and TypeScript with automatic JSON responses, collection support, and pagination handling.",
   "keywords": [
     "api",
@@ -50,14 +50,13 @@
     "@eslint/markdown": "^7.5.1",
     "@types/express": "^4.17.21",
     "@types/node": "^20.10.6",
-    "@types/supertest": "^6.0.3",
     "@vitest/coverage-v8": "4.0.18",
     "arkormx": "^0.2.6",
     "barrelize": "^1.7.3",
     "eslint": "^10.0.0",
     "express": "^5.1.0",
     "h3": "2.0.1-rc.14",
-    "supertest": "^7.1.1",
+    "parasito": "^0.1.6",
     "tsdown": "^0.20.3",
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
@@ -85,6 +84,6 @@
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs",
     "version:packages": "pnpm -r --filter \"@resora/*\" version:patch && git add . && git commit -m \"chore: bump package versions\"",
-    "publish:packages": "pnpm version:packages && pnpm -r --filter \"@arkstack/*\" publish --access public"
+    "publish:packages": "pnpm version:packages && pnpm -r --filter \"@resora/*\" publish --access public"
   }
 }