resora 1.2.11 → 1.3.0

package/dist/index.cjs

@@ -1561,6 +1561,12 @@ var BaseSerializer = class {
 		return extractResponseFromCtx(getCtx() ?? this.constructor.ctx);
 	}
 	/**
+	* Resolve the active request context for data transformation hooks.
+	*/
+	resolveSerializationContext() {
+		return getCtx() ?? this.constructor.ctx;
+	}
+	/**
 	* Dispatch a body to a raw response object when it exposes a send() transport method.
 	*
 	* @param raw
@@ -1781,7 +1787,7 @@ var GenericResource = class GenericResource extends BaseSerializer {
 	/**
 	* Get the original resource data
 	*/
-	data() {
+	data(_ctx) {
 		return this.resource;
 	}
 	/**
@@ -1853,8 +1859,9 @@ var GenericResource = class GenericResource extends BaseSerializer {
 	json() {
 		if (!this.called.json) {
 			this.called.json = true;
-			let data = normalizeSerializableData(this.data());
-			if (Array.isArray(data) && this.collects) data = data.map((item) => new this.collects(item).data());
+			const ctx = this.resolveSerializationContext();
+			let data = normalizeSerializableData(this.data(ctx));
+			if (Array.isArray(data) && this.collects) data = data.map((item) => new this.collects(item).data(ctx));
 			if (!Array.isArray(data) && data && typeof data.data !== "undefined") data = data.data;
 			data = sanitizeConditionalAttributes(data);
 			const paginationExtras = buildPaginationExtras(this.resource);
@@ -2098,15 +2105,15 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 	getSourceData() {
 		return Array.isArray(this.resource) ? this.resource : isArkormLikeCollection(this.resource) ? this.resource.all() : this.resource.data;
 	}
-	resolveObjectData() {
+	resolveObjectData(ctx) {
 		let data = this.getSourceData();
-		if (this.collects) data = data.map((item) => new this.collects(item).data());
+		if (this.collects) data = data.map((item) => new this.collects(item).data(ctx));
 		return normalizeSerializableData(data);
 	}
 	/**
 	* Get the original resource data
 	*/
-	data() {
+	data(_ctx) {
 		return this.getSourceData();
 	}
 	/**
@@ -2186,8 +2193,9 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 	json() {
 		if (!this.called.json) {
 			this.called.json = true;
-			let data = this.data();
-			if (this.collects && this.data === ResourceCollection.prototype.data) data = data.map((item) => new this.collects(item).data());
+			const ctx = this.resolveSerializationContext();
+			let data = this.data(ctx);
+			if (this.collects && this.data === ResourceCollection.prototype.data) data = data.map((item) => new this.collects(item).data(ctx));
 			data = normalizeSerializableData(data);
 			data = sanitizeConditionalAttributes(data);
 			const paginationExtras = !Array.isArray(this.resource) ? buildPaginationExtras(this.resource) : {};
@@ -2228,7 +2236,7 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 	*/
 	toObject() {
 		this.called.toObject = true;
-		return this.resolveObjectData();
+		return this.resolveObjectData(this.resolveSerializationContext());
 	}
 	/**
 	* Convert resource to object format and return original data.
@@ -2447,7 +2455,7 @@ var Resource = class Resource extends BaseSerializer {
 	/**
 	* Get the original resource data
 	*/
-	data() {
+	data(_ctx) {
 		return this.toObject();
 	}
 	/**
@@ -2496,7 +2504,8 @@ var Resource = class Resource extends BaseSerializer {
 	json() {
 		if (!this.called.json) {
 			this.called.json = true;
-			let data = normalizeSerializableData(this.data());
+			const ctx = this.resolveSerializationContext();
+			let data = normalizeSerializableData(this.data(ctx));
 			if (!Array.isArray(data) && data && typeof data.data !== "undefined") data = data.data;
 			data = sanitizeConditionalAttributes(data);
 			const caseStyle = this.resolveSerializerCaseStyle(this.constructor);

package/dist/index.d.cts

@@ -601,6 +601,10 @@ declare abstract class BaseSerializer<TResource = any> {
    * @returns
    */
   protected resolveRawResponse<TRawResponse>(response?: TRawResponse): TRawResponse | undefined;
+  /**
+   * Resolve the active request context for data transformation hooks.
+   */
+  protected resolveSerializationContext(): unknown;
   /**
    * Dispatch a body to a raw response object when it exposes a send() transport method.
    *
@@ -742,7 +746,7 @@ declare class ResourceCollection<R extends ResourceData[] | Collectible | Collec
   /**
    * Get the original resource data
    */
-  data(): (R extends Collectible ? R["data"][number] : R extends PaginatorLike<infer TPaginatorData> ? TPaginatorData : R extends CollectionLike<infer TCollectionData> ? TCollectionData : R extends ResourceData[] ? R[number] : never)[];
+  data(_ctx?: unknown): (R extends Collectible ? R["data"][number] : R extends PaginatorLike<infer TPaginatorData> ? TPaginatorData : R extends CollectionLike<infer TCollectionData> ? TCollectionData : R extends ResourceData[] ? R[number] : never)[];
   /**
    * Get the current serialized output body.
    */
@@ -879,7 +883,7 @@ declare class Resource<R extends ResourceData | NonCollectible = ResourceData> e
   /**
    * Get the original resource data
    */
-  data(): R extends NonCollectible ? R["data"] : R;
+  data(_ctx?: unknown): R extends NonCollectible ? R["data"] : R;
   /**
    * Get the current serialized output body.
    */
@@ -988,7 +992,7 @@ declare class GenericResource<R extends NonCollectible | Collectible | Collectio
   /**
    * Get the original resource data
    */
-  data(): R;
+  data(_ctx?: unknown): R;
   /**
    * Get the current serialized output body.
    */

package/dist/index.d.mts

@@ -601,6 +601,10 @@ declare abstract class BaseSerializer<TResource = any> {
    * @returns
    */
   protected resolveRawResponse<TRawResponse>(response?: TRawResponse): TRawResponse | undefined;
+  /**
+   * Resolve the active request context for data transformation hooks.
+   */
+  protected resolveSerializationContext(): unknown;
   /**
    * Dispatch a body to a raw response object when it exposes a send() transport method.
    *
@@ -742,7 +746,7 @@ declare class ResourceCollection<R extends ResourceData[] | Collectible | Collec
   /**
    * Get the original resource data
    */
-  data(): (R extends Collectible ? R["data"][number] : R extends PaginatorLike<infer TPaginatorData> ? TPaginatorData : R extends CollectionLike<infer TCollectionData> ? TCollectionData : R extends ResourceData[] ? R[number] : never)[];
+  data(_ctx?: unknown): (R extends Collectible ? R["data"][number] : R extends PaginatorLike<infer TPaginatorData> ? TPaginatorData : R extends CollectionLike<infer TCollectionData> ? TCollectionData : R extends ResourceData[] ? R[number] : never)[];
   /**
    * Get the current serialized output body.
    */
@@ -879,7 +883,7 @@ declare class Resource<R extends ResourceData | NonCollectible = ResourceData> e
   /**
    * Get the original resource data
    */
-  data(): R extends NonCollectible ? R["data"] : R;
+  data(_ctx?: unknown): R extends NonCollectible ? R["data"] : R;
   /**
    * Get the current serialized output body.
    */
@@ -988,7 +992,7 @@ declare class GenericResource<R extends NonCollectible | Collectible | Collectio
   /**
    * Get the original resource data
    */
-  data(): R;
+  data(_ctx?: unknown): R;
   /**
    * Get the current serialized output body.
    */

package/dist/index.mjs

@@ -1532,6 +1532,12 @@ var BaseSerializer = class {
 		return extractResponseFromCtx(getCtx() ?? this.constructor.ctx);
 	}
 	/**
+	* Resolve the active request context for data transformation hooks.
+	*/
+	resolveSerializationContext() {
+		return getCtx() ?? this.constructor.ctx;
+	}
+	/**
 	* Dispatch a body to a raw response object when it exposes a send() transport method.
 	*
 	* @param raw
@@ -1752,7 +1758,7 @@ var GenericResource = class GenericResource extends BaseSerializer {
 	/**
 	* Get the original resource data
 	*/
-	data() {
+	data(_ctx) {
 		return this.resource;
 	}
 	/**
@@ -1824,8 +1830,9 @@ var GenericResource = class GenericResource extends BaseSerializer {
 	json() {
 		if (!this.called.json) {
 			this.called.json = true;
-			let data = normalizeSerializableData(this.data());
-			if (Array.isArray(data) && this.collects) data = data.map((item) => new this.collects(item).data());
+			const ctx = this.resolveSerializationContext();
+			let data = normalizeSerializableData(this.data(ctx));
+			if (Array.isArray(data) && this.collects) data = data.map((item) => new this.collects(item).data(ctx));
 			if (!Array.isArray(data) && data && typeof data.data !== "undefined") data = data.data;
 			data = sanitizeConditionalAttributes(data);
 			const paginationExtras = buildPaginationExtras(this.resource);
@@ -2069,15 +2076,15 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 	getSourceData() {
 		return Array.isArray(this.resource) ? this.resource : isArkormLikeCollection(this.resource) ? this.resource.all() : this.resource.data;
 	}
-	resolveObjectData() {
+	resolveObjectData(ctx) {
 		let data = this.getSourceData();
-		if (this.collects) data = data.map((item) => new this.collects(item).data());
+		if (this.collects) data = data.map((item) => new this.collects(item).data(ctx));
 		return normalizeSerializableData(data);
 	}
 	/**
 	* Get the original resource data
 	*/
-	data() {
+	data(_ctx) {
 		return this.getSourceData();
 	}
 	/**
@@ -2157,8 +2164,9 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 	json() {
 		if (!this.called.json) {
 			this.called.json = true;
-			let data = this.data();
-			if (this.collects && this.data === ResourceCollection.prototype.data) data = data.map((item) => new this.collects(item).data());
+			const ctx = this.resolveSerializationContext();
+			let data = this.data(ctx);
+			if (this.collects && this.data === ResourceCollection.prototype.data) data = data.map((item) => new this.collects(item).data(ctx));
 			data = normalizeSerializableData(data);
 			data = sanitizeConditionalAttributes(data);
 			const paginationExtras = !Array.isArray(this.resource) ? buildPaginationExtras(this.resource) : {};
@@ -2199,7 +2207,7 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 	*/
 	toObject() {
 		this.called.toObject = true;
-		return this.resolveObjectData();
+		return this.resolveObjectData(this.resolveSerializationContext());
 	}
 	/**
 	* Convert resource to object format and return original data.
@@ -2418,7 +2426,7 @@ var Resource = class Resource extends BaseSerializer {
 	/**
 	* Get the original resource data
 	*/
-	data() {
+	data(_ctx) {
 		return this.toObject();
 	}
 	/**
@@ -2467,7 +2475,8 @@ var Resource = class Resource extends BaseSerializer {
 	json() {
 		if (!this.called.json) {
 			this.called.json = true;
-			let data = normalizeSerializableData(this.data());
+			const ctx = this.resolveSerializationContext();
+			let data = normalizeSerializableData(this.data(ctx));
 			if (!Array.isArray(data) && data && typeof data.data !== "undefined") data = data.data;
 			data = sanitizeConditionalAttributes(data);
 			const caseStyle = this.resolveSerializerCaseStyle(this.constructor);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resora",
-  "version": "1.2.11",
+  "version": "1.3.0",
   "description": "A structured API response layer for Node.js and TypeScript with automatic JSON responses, collection support, and pagination handling.",
   "keywords": [
     "api",
@@ -51,7 +51,7 @@
     "@types/express": "^4.17.21",
     "@types/node": "^20.10.6",
     "@vitest/coverage-v8": "4.0.18",
-    "arkormx": "^2.3.1",
+    "arkormx": "^2.4.0",
     "barrelize": "^1.7.3",
     "eslint": "^10.0.0",
     "express": "^5.1.0",