resora 1.2.12 → 1.3.1

package/dist/index.cjs

@@ -1466,6 +1466,7 @@ var BaseSerializer = class {
 	static ctx;
 	instanceConfig;
 	additionalMeta;
+	serializationPromise;
 	called = {};
 	constructor() {
 		loadRuntimeConfig();
@@ -1561,6 +1562,18 @@ var BaseSerializer = class {
 		return extractResponseFromCtx(getCtx() ?? this.constructor.ctx);
 	}
 	/**
+	* Resolve the active request context for data transformation hooks.
+	*/
+	resolveSerializationContext() {
+		return getCtx() ?? this.constructor.ctx;
+	}
+	isPromiseLike(value) {
+		return !!value && (typeof value === "object" || typeof value === "function") && typeof value.then === "function";
+	}
+	waitForSerialization() {
+		return this.serializationPromise ?? Promise.resolve();
+	}
+	/**
 	* Dispatch a body to a raw response object when it exposes a send() transport method.
 	*
 	* @param raw
@@ -1635,27 +1648,28 @@ var BaseSerializer = class {
 	runThen(input) {
 		this.called.then = true;
 		input.ensureJson();
-		const initialBody = input.body();
-		let response;
-		if (typeof input.rawResponse !== "undefined") {
-			response = input.createServerResponse(input.rawResponse, initialBody);
-			this.called.withResponse = true;
-			input.callWithResponse(response, input.rawResponse);
-		} else {
-			this.called.withResponse = true;
-			input.callWithResponse();
-		}
-		const resolvedBody = input.body();
-		if (typeof response?.setBody === "function") response.setBody(resolvedBody);
-		const dispatchedBody = this.applyResponsePlugins({
-			body: resolvedBody,
-			rawResponse: input.rawResponse,
-			response
-		});
-		const resolved = Promise.resolve(dispatchedBody).then(input.onfulfilled, input.onrejected);
-		if (typeof response?.send === "function") response.send(dispatchedBody);
-		else if (typeof input.rawResponse !== "undefined" && input.sendRawResponse) input.sendRawResponse(input.rawResponse, dispatchedBody);
-		return resolved;
+		return this.waitForSerialization().then(() => {
+			const initialBody = input.body();
+			let response;
+			if (typeof input.rawResponse !== "undefined") {
+				response = input.createServerResponse(input.rawResponse, initialBody);
+				this.called.withResponse = true;
+				input.callWithResponse(response, input.rawResponse);
+			} else {
+				this.called.withResponse = true;
+				input.callWithResponse();
+			}
+			const resolvedBody = input.body();
+			if (typeof response?.setBody === "function") response.setBody(resolvedBody);
+			const dispatchedBody = this.applyResponsePlugins({
+				body: resolvedBody,
+				rawResponse: input.rawResponse,
+				response
+			});
+			if (typeof response?.send === "function") response.send(dispatchedBody);
+			else if (typeof input.rawResponse !== "undefined" && input.sendRawResponse) input.sendRawResponse(input.rawResponse, dispatchedBody);
+			return dispatchedBody;
+		}).then(input.onfulfilled, input.onrejected);
 	}
 	/**
 	* Get or set the resource-level configuration for this serializer instance.
@@ -1781,7 +1795,7 @@ var GenericResource = class GenericResource extends BaseSerializer {
 	/**
 	* Get the original resource data
 	*/
-	data() {
+	data(_ctx) {
 		return this.resource;
 	}
 	/**
@@ -1845,16 +1859,10 @@ var GenericResource = class GenericResource extends BaseSerializer {
 		const { wrap, rootKey, factory } = this.resolveResponseStructure();
 		return factory || !wrap ? void 0 : rootKey;
 	}
-	/**
-	* Convert resource to JSON response format
-	* 
-	* @returns 
-	*/
-	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());
+	serializeGenericResource(resource, ctx) {
+		let data = normalizeSerializableData(resource);
+		const serialize = (resolvedData) => {
+			data = resolvedData;
 			if (!Array.isArray(data) && data && typeof data.data !== "undefined") data = data.data;
 			data = sanitizeConditionalAttributes(data);
 			const paginationExtras = buildPaginationExtras(this.resource);
@@ -1885,6 +1893,32 @@ var GenericResource = class GenericResource extends BaseSerializer {
 				...customMeta || {}
 			}, rootKey);
 			this.body = this.applySerializePlugins(this.body);
+		};
+		if (Array.isArray(data) && this.collects) {
+			const collected = data.map((item) => new this.collects(item).data(ctx));
+			if (collected.some((item) => this.isPromiseLike(item))) return Promise.all(collected).then(serialize);
+			data = collected;
+		}
+		serialize(data);
+	}
+	/**
+	* Convert resource to JSON response format
+	* 
+	* @returns 
+	*/
+	json() {
+		if (!this.called.json) {
+			this.called.json = true;
+			const ctx = this.resolveSerializationContext();
+			const resource = this.data(ctx);
+			if (this.isPromiseLike(resource)) this.serializationPromise = Promise.resolve(resource).then((resolved) => {
+				const result = this.serializeGenericResource(resolved, ctx);
+				if (this.isPromiseLike(result)) return result;
+			});
+			else {
+				const result = this.serializeGenericResource(resource, ctx);
+				if (this.isPromiseLike(result)) this.serializationPromise = Promise.resolve(result);
+			}
 		}
 		return this;
 	}
@@ -2098,15 +2132,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();
 	}
 	/**
@@ -2178,6 +2212,46 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 		const { wrap, rootKey, factory } = this.resolveResponseStructure();
 		return factory || !wrap ? void 0 : rootKey;
 	}
+	serializeCollectionData(items) {
+		let data = normalizeSerializableData(items);
+		data = sanitizeConditionalAttributes(data);
+		const paginationExtras = !Array.isArray(this.resource) ? buildPaginationExtras(this.resource) : {};
+		const { metaKey } = getPaginationExtraKeys();
+		const configuredMeta = metaKey ? paginationExtras[metaKey] : void 0;
+		if (metaKey) delete paginationExtras[metaKey];
+		const caseStyle = this.resolveSerializerCaseStyle(this.constructor, this.resolveCollectsConfig());
+		if (caseStyle) {
+			const transformer = getCaseTransformer(caseStyle);
+			data = transformKeys(data, transformer);
+		}
+		const customMeta = this.resolveMergedMeta(ResourceCollection.prototype.with);
+		const { wrap, rootKey, factory } = this.resolveResponseStructure();
+		this.body = buildResponseEnvelope({
+			payload: data,
+			meta: configuredMeta,
+			metaKey,
+			wrap,
+			rootKey,
+			factory,
+			context: {
+				type: "collection",
+				resource: this.resource
+			}
+		});
+		this.body = appendRootProperties(this.body, {
+			...paginationExtras,
+			...customMeta || {}
+		}, rootKey);
+		this.body = this.applySerializePlugins(this.body);
+	}
+	resolveCollectionDataForSerialization(items, ctx) {
+		if (this.collects && this.data === ResourceCollection.prototype.data) {
+			const collected = items.map((item) => new this.collects(item).data(ctx));
+			if (collected.some((item) => this.isPromiseLike(item))) return Promise.all(collected);
+			return collected;
+		}
+		return items;
+	}
 	/**
 	* Convert resource to JSON response format
 	* 
@@ -2186,38 +2260,20 @@ 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());
-			data = normalizeSerializableData(data);
-			data = sanitizeConditionalAttributes(data);
-			const paginationExtras = !Array.isArray(this.resource) ? buildPaginationExtras(this.resource) : {};
-			const { metaKey } = getPaginationExtraKeys();
-			const configuredMeta = metaKey ? paginationExtras[metaKey] : void 0;
-			if (metaKey) delete paginationExtras[metaKey];
-			const caseStyle = this.resolveSerializerCaseStyle(this.constructor, this.resolveCollectsConfig());
-			if (caseStyle) {
-				const transformer = getCaseTransformer(caseStyle);
-				data = transformKeys(data, transformer);
+			const ctx = this.resolveSerializationContext();
+			const data = this.data(ctx);
+			const serialize = (items) => {
+				const resolvedData = this.resolveCollectionDataForSerialization(items, ctx);
+				if (this.isPromiseLike(resolvedData)) return resolvedData.then((resolved) => {
+					this.serializeCollectionData(resolved);
+				});
+				this.serializeCollectionData(resolvedData);
+			};
+			if (this.isPromiseLike(data)) this.serializationPromise = Promise.resolve(data).then(serialize);
+			else {
+				const result = serialize(data);
+				if (this.isPromiseLike(result)) this.serializationPromise = Promise.resolve(result);
 			}
-			const customMeta = this.resolveMergedMeta(ResourceCollection.prototype.with);
-			const { wrap, rootKey, factory } = this.resolveResponseStructure();
-			this.body = buildResponseEnvelope({
-				payload: data,
-				meta: configuredMeta,
-				metaKey,
-				wrap,
-				rootKey,
-				factory,
-				context: {
-					type: "collection",
-					resource: this.resource
-				}
-			});
-			this.body = appendRootProperties(this.body, {
-				...paginationExtras,
-				...customMeta || {}
-			}, rootKey);
-			this.body = this.applySerializePlugins(this.body);
 		}
 		return this;
 	}
@@ -2228,7 +2284,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 +2503,7 @@ var Resource = class Resource extends BaseSerializer {
 	/**
 	* Get the original resource data
 	*/
-	data() {
+	data(_ctx) {
 		return this.toObject();
 	}
 	/**
@@ -2488,6 +2544,30 @@ var Resource = class Resource extends BaseSerializer {
 		const { wrap, rootKey, factory } = this.resolveResponseStructure();
 		return factory || !wrap ? void 0 : rootKey;
 	}
+	serializeResource(resource) {
+		let data = normalizeSerializableData(resource);
+		if (!Array.isArray(data) && data && typeof data.data !== "undefined") data = data.data;
+		data = sanitizeConditionalAttributes(data);
+		const caseStyle = this.resolveSerializerCaseStyle(this.constructor);
+		if (caseStyle) {
+			const transformer = getCaseTransformer(caseStyle);
+			data = transformKeys(data, transformer);
+		}
+		const customMeta = this.resolveMergedMeta(Resource.prototype.with);
+		const { wrap, rootKey, factory } = this.resolveResponseStructure();
+		this.body = buildResponseEnvelope({
+			payload: data,
+			wrap,
+			rootKey,
+			factory,
+			context: {
+				type: "resource",
+				resource: this.resource
+			}
+		});
+		this.body = appendRootProperties(this.body, customMeta, rootKey);
+		this.body = this.applySerializePlugins(this.body);
+	}
 	/**
 	* Convert resource to JSON response format
 	* 
@@ -2496,28 +2576,12 @@ var Resource = class Resource extends BaseSerializer {
 	json() {
 		if (!this.called.json) {
 			this.called.json = true;
-			let data = normalizeSerializableData(this.data());
-			if (!Array.isArray(data) && data && typeof data.data !== "undefined") data = data.data;
-			data = sanitizeConditionalAttributes(data);
-			const caseStyle = this.resolveSerializerCaseStyle(this.constructor);
-			if (caseStyle) {
-				const transformer = getCaseTransformer(caseStyle);
-				data = transformKeys(data, transformer);
-			}
-			const customMeta = this.resolveMergedMeta(Resource.prototype.with);
-			const { wrap, rootKey, factory } = this.resolveResponseStructure();
-			this.body = buildResponseEnvelope({
-				payload: data,
-				wrap,
-				rootKey,
-				factory,
-				context: {
-					type: "resource",
-					resource: this.resource
-				}
+			const ctx = this.resolveSerializationContext();
+			const resource = this.data(ctx);
+			if (this.isPromiseLike(resource)) this.serializationPromise = Promise.resolve(resource).then((resolved) => {
+				this.serializeResource(resolved);
 			});
-			this.body = appendRootProperties(this.body, customMeta, rootKey);
-			this.body = this.applySerializePlugins(this.body);
+			else this.serializeResource(resource);
 		}
 		return this;
 	}

package/dist/index.d.cts

@@ -519,6 +519,7 @@ declare abstract class BaseSerializer<TResource = any> {
   protected static ctx?: Response | H3Event | Record<string, any>;
   protected instanceConfig?: ResourceLevelConfig;
   protected additionalMeta?: MetaData;
+  protected serializationPromise?: Promise<void>;
   protected called: {
     json?: boolean;
     data?: boolean;
@@ -601,6 +602,12 @@ 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;
+  protected isPromiseLike<T = any>(value: unknown): value is PromiseLike<T>;
+  protected waitForSerialization(): Promise<void>;
   /**
    * Dispatch a body to a raw response object when it exposes a send() transport method.
    *
@@ -742,7 +749,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?: any): any;
   /**
    * Get the current serialized output body.
    */
@@ -782,6 +789,8 @@ declare class ResourceCollection<R extends ResourceData[] | Collectible | Collec
    * @returns The key to use for the response payload, or undefined if no key is needed.
    */
   private getPayloadKey;
+  private serializeCollectionData;
+  private resolveCollectionDataForSerialization;
   /**
    * Convert resource to JSON response format
    *
@@ -879,7 +888,7 @@ declare class Resource<R extends ResourceData | NonCollectible = ResourceData> e
   /**
    * Get the original resource data
    */
-  data(): R extends NonCollectible ? R["data"] : R;
+  data(_ctx?: any): any;
   /**
    * Get the current serialized output body.
    */
@@ -899,6 +908,7 @@ declare class Resource<R extends ResourceData | NonCollectible = ResourceData> e
   protected getResourceForMeta(): R;
   protected getSerializerType(): "resource";
   private getPayloadKey;
+  private serializeResource;
   /**
    * Convert resource to JSON response format
    *
@@ -988,7 +998,7 @@ declare class GenericResource<R extends NonCollectible | Collectible | Collectio
   /**
    * Get the original resource data
    */
-  data(): R;
+  data(_ctx?: any): any;
   /**
    * Get the current serialized output body.
    */
@@ -1020,6 +1030,7 @@ declare class GenericResource<R extends NonCollectible | Collectible | Collectio
   protected getResourceForMeta(): R;
   protected getSerializerType(): "generic";
   private getPayloadKey;
+  private serializeGenericResource;
   /**
    * Convert resource to JSON response format
    *

package/dist/index.d.mts

@@ -519,6 +519,7 @@ declare abstract class BaseSerializer<TResource = any> {
   protected static ctx?: Response | H3Event | Record<string, any>;
   protected instanceConfig?: ResourceLevelConfig;
   protected additionalMeta?: MetaData;
+  protected serializationPromise?: Promise<void>;
   protected called: {
     json?: boolean;
     data?: boolean;
@@ -601,6 +602,12 @@ 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;
+  protected isPromiseLike<T = any>(value: unknown): value is PromiseLike<T>;
+  protected waitForSerialization(): Promise<void>;
   /**
    * Dispatch a body to a raw response object when it exposes a send() transport method.
    *
@@ -742,7 +749,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?: any): any;
   /**
    * Get the current serialized output body.
    */
@@ -782,6 +789,8 @@ declare class ResourceCollection<R extends ResourceData[] | Collectible | Collec
    * @returns The key to use for the response payload, or undefined if no key is needed.
    */
   private getPayloadKey;
+  private serializeCollectionData;
+  private resolveCollectionDataForSerialization;
   /**
    * Convert resource to JSON response format
    *
@@ -879,7 +888,7 @@ declare class Resource<R extends ResourceData | NonCollectible = ResourceData> e
   /**
    * Get the original resource data
    */
-  data(): R extends NonCollectible ? R["data"] : R;
+  data(_ctx?: any): any;
   /**
    * Get the current serialized output body.
    */
@@ -899,6 +908,7 @@ declare class Resource<R extends ResourceData | NonCollectible = ResourceData> e
   protected getResourceForMeta(): R;
   protected getSerializerType(): "resource";
   private getPayloadKey;
+  private serializeResource;
   /**
    * Convert resource to JSON response format
    *
@@ -988,7 +998,7 @@ declare class GenericResource<R extends NonCollectible | Collectible | Collectio
   /**
    * Get the original resource data
    */
-  data(): R;
+  data(_ctx?: any): any;
   /**
    * Get the current serialized output body.
    */
@@ -1020,6 +1030,7 @@ declare class GenericResource<R extends NonCollectible | Collectible | Collectio
   protected getResourceForMeta(): R;
   protected getSerializerType(): "generic";
   private getPayloadKey;
+  private serializeGenericResource;
   /**
    * Convert resource to JSON response format
    *

package/dist/index.mjs

@@ -1437,6 +1437,7 @@ var BaseSerializer = class {
 	static ctx;
 	instanceConfig;
 	additionalMeta;
+	serializationPromise;
 	called = {};
 	constructor() {
 		loadRuntimeConfig();
@@ -1532,6 +1533,18 @@ var BaseSerializer = class {
 		return extractResponseFromCtx(getCtx() ?? this.constructor.ctx);
 	}
 	/**
+	* Resolve the active request context for data transformation hooks.
+	*/
+	resolveSerializationContext() {
+		return getCtx() ?? this.constructor.ctx;
+	}
+	isPromiseLike(value) {
+		return !!value && (typeof value === "object" || typeof value === "function") && typeof value.then === "function";
+	}
+	waitForSerialization() {
+		return this.serializationPromise ?? Promise.resolve();
+	}
+	/**
 	* Dispatch a body to a raw response object when it exposes a send() transport method.
 	*
 	* @param raw
@@ -1606,27 +1619,28 @@ var BaseSerializer = class {
 	runThen(input) {
 		this.called.then = true;
 		input.ensureJson();
-		const initialBody = input.body();
-		let response;
-		if (typeof input.rawResponse !== "undefined") {
-			response = input.createServerResponse(input.rawResponse, initialBody);
-			this.called.withResponse = true;
-			input.callWithResponse(response, input.rawResponse);
-		} else {
-			this.called.withResponse = true;
-			input.callWithResponse();
-		}
-		const resolvedBody = input.body();
-		if (typeof response?.setBody === "function") response.setBody(resolvedBody);
-		const dispatchedBody = this.applyResponsePlugins({
-			body: resolvedBody,
-			rawResponse: input.rawResponse,
-			response
-		});
-		const resolved = Promise.resolve(dispatchedBody).then(input.onfulfilled, input.onrejected);
-		if (typeof response?.send === "function") response.send(dispatchedBody);
-		else if (typeof input.rawResponse !== "undefined" && input.sendRawResponse) input.sendRawResponse(input.rawResponse, dispatchedBody);
-		return resolved;
+		return this.waitForSerialization().then(() => {
+			const initialBody = input.body();
+			let response;
+			if (typeof input.rawResponse !== "undefined") {
+				response = input.createServerResponse(input.rawResponse, initialBody);
+				this.called.withResponse = true;
+				input.callWithResponse(response, input.rawResponse);
+			} else {
+				this.called.withResponse = true;
+				input.callWithResponse();
+			}
+			const resolvedBody = input.body();
+			if (typeof response?.setBody === "function") response.setBody(resolvedBody);
+			const dispatchedBody = this.applyResponsePlugins({
+				body: resolvedBody,
+				rawResponse: input.rawResponse,
+				response
+			});
+			if (typeof response?.send === "function") response.send(dispatchedBody);
+			else if (typeof input.rawResponse !== "undefined" && input.sendRawResponse) input.sendRawResponse(input.rawResponse, dispatchedBody);
+			return dispatchedBody;
+		}).then(input.onfulfilled, input.onrejected);
 	}
 	/**
 	* Get or set the resource-level configuration for this serializer instance.
@@ -1752,7 +1766,7 @@ var GenericResource = class GenericResource extends BaseSerializer {
 	/**
 	* Get the original resource data
 	*/
-	data() {
+	data(_ctx) {
 		return this.resource;
 	}
 	/**
@@ -1816,16 +1830,10 @@ var GenericResource = class GenericResource extends BaseSerializer {
 		const { wrap, rootKey, factory } = this.resolveResponseStructure();
 		return factory || !wrap ? void 0 : rootKey;
 	}
-	/**
-	* Convert resource to JSON response format
-	* 
-	* @returns 
-	*/
-	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());
+	serializeGenericResource(resource, ctx) {
+		let data = normalizeSerializableData(resource);
+		const serialize = (resolvedData) => {
+			data = resolvedData;
 			if (!Array.isArray(data) && data && typeof data.data !== "undefined") data = data.data;
 			data = sanitizeConditionalAttributes(data);
 			const paginationExtras = buildPaginationExtras(this.resource);
@@ -1856,6 +1864,32 @@ var GenericResource = class GenericResource extends BaseSerializer {
 				...customMeta || {}
 			}, rootKey);
 			this.body = this.applySerializePlugins(this.body);
+		};
+		if (Array.isArray(data) && this.collects) {
+			const collected = data.map((item) => new this.collects(item).data(ctx));
+			if (collected.some((item) => this.isPromiseLike(item))) return Promise.all(collected).then(serialize);
+			data = collected;
+		}
+		serialize(data);
+	}
+	/**
+	* Convert resource to JSON response format
+	* 
+	* @returns 
+	*/
+	json() {
+		if (!this.called.json) {
+			this.called.json = true;
+			const ctx = this.resolveSerializationContext();
+			const resource = this.data(ctx);
+			if (this.isPromiseLike(resource)) this.serializationPromise = Promise.resolve(resource).then((resolved) => {
+				const result = this.serializeGenericResource(resolved, ctx);
+				if (this.isPromiseLike(result)) return result;
+			});
+			else {
+				const result = this.serializeGenericResource(resource, ctx);
+				if (this.isPromiseLike(result)) this.serializationPromise = Promise.resolve(result);
+			}
 		}
 		return this;
 	}
@@ -2069,15 +2103,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();
 	}
 	/**
@@ -2149,6 +2183,46 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 		const { wrap, rootKey, factory } = this.resolveResponseStructure();
 		return factory || !wrap ? void 0 : rootKey;
 	}
+	serializeCollectionData(items) {
+		let data = normalizeSerializableData(items);
+		data = sanitizeConditionalAttributes(data);
+		const paginationExtras = !Array.isArray(this.resource) ? buildPaginationExtras(this.resource) : {};
+		const { metaKey } = getPaginationExtraKeys();
+		const configuredMeta = metaKey ? paginationExtras[metaKey] : void 0;
+		if (metaKey) delete paginationExtras[metaKey];
+		const caseStyle = this.resolveSerializerCaseStyle(this.constructor, this.resolveCollectsConfig());
+		if (caseStyle) {
+			const transformer = getCaseTransformer(caseStyle);
+			data = transformKeys(data, transformer);
+		}
+		const customMeta = this.resolveMergedMeta(ResourceCollection.prototype.with);
+		const { wrap, rootKey, factory } = this.resolveResponseStructure();
+		this.body = buildResponseEnvelope({
+			payload: data,
+			meta: configuredMeta,
+			metaKey,
+			wrap,
+			rootKey,
+			factory,
+			context: {
+				type: "collection",
+				resource: this.resource
+			}
+		});
+		this.body = appendRootProperties(this.body, {
+			...paginationExtras,
+			...customMeta || {}
+		}, rootKey);
+		this.body = this.applySerializePlugins(this.body);
+	}
+	resolveCollectionDataForSerialization(items, ctx) {
+		if (this.collects && this.data === ResourceCollection.prototype.data) {
+			const collected = items.map((item) => new this.collects(item).data(ctx));
+			if (collected.some((item) => this.isPromiseLike(item))) return Promise.all(collected);
+			return collected;
+		}
+		return items;
+	}
 	/**
 	* Convert resource to JSON response format
 	* 
@@ -2157,38 +2231,20 @@ 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());
-			data = normalizeSerializableData(data);
-			data = sanitizeConditionalAttributes(data);
-			const paginationExtras = !Array.isArray(this.resource) ? buildPaginationExtras(this.resource) : {};
-			const { metaKey } = getPaginationExtraKeys();
-			const configuredMeta = metaKey ? paginationExtras[metaKey] : void 0;
-			if (metaKey) delete paginationExtras[metaKey];
-			const caseStyle = this.resolveSerializerCaseStyle(this.constructor, this.resolveCollectsConfig());
-			if (caseStyle) {
-				const transformer = getCaseTransformer(caseStyle);
-				data = transformKeys(data, transformer);
+			const ctx = this.resolveSerializationContext();
+			const data = this.data(ctx);
+			const serialize = (items) => {
+				const resolvedData = this.resolveCollectionDataForSerialization(items, ctx);
+				if (this.isPromiseLike(resolvedData)) return resolvedData.then((resolved) => {
+					this.serializeCollectionData(resolved);
+				});
+				this.serializeCollectionData(resolvedData);
+			};
+			if (this.isPromiseLike(data)) this.serializationPromise = Promise.resolve(data).then(serialize);
+			else {
+				const result = serialize(data);
+				if (this.isPromiseLike(result)) this.serializationPromise = Promise.resolve(result);
 			}
-			const customMeta = this.resolveMergedMeta(ResourceCollection.prototype.with);
-			const { wrap, rootKey, factory } = this.resolveResponseStructure();
-			this.body = buildResponseEnvelope({
-				payload: data,
-				meta: configuredMeta,
-				metaKey,
-				wrap,
-				rootKey,
-				factory,
-				context: {
-					type: "collection",
-					resource: this.resource
-				}
-			});
-			this.body = appendRootProperties(this.body, {
-				...paginationExtras,
-				...customMeta || {}
-			}, rootKey);
-			this.body = this.applySerializePlugins(this.body);
 		}
 		return this;
 	}
@@ -2199,7 +2255,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 +2474,7 @@ var Resource = class Resource extends BaseSerializer {
 	/**
 	* Get the original resource data
 	*/
-	data() {
+	data(_ctx) {
 		return this.toObject();
 	}
 	/**
@@ -2459,6 +2515,30 @@ var Resource = class Resource extends BaseSerializer {
 		const { wrap, rootKey, factory } = this.resolveResponseStructure();
 		return factory || !wrap ? void 0 : rootKey;
 	}
+	serializeResource(resource) {
+		let data = normalizeSerializableData(resource);
+		if (!Array.isArray(data) && data && typeof data.data !== "undefined") data = data.data;
+		data = sanitizeConditionalAttributes(data);
+		const caseStyle = this.resolveSerializerCaseStyle(this.constructor);
+		if (caseStyle) {
+			const transformer = getCaseTransformer(caseStyle);
+			data = transformKeys(data, transformer);
+		}
+		const customMeta = this.resolveMergedMeta(Resource.prototype.with);
+		const { wrap, rootKey, factory } = this.resolveResponseStructure();
+		this.body = buildResponseEnvelope({
+			payload: data,
+			wrap,
+			rootKey,
+			factory,
+			context: {
+				type: "resource",
+				resource: this.resource
+			}
+		});
+		this.body = appendRootProperties(this.body, customMeta, rootKey);
+		this.body = this.applySerializePlugins(this.body);
+	}
 	/**
 	* Convert resource to JSON response format
 	* 
@@ -2467,28 +2547,12 @@ var Resource = class Resource extends BaseSerializer {
 	json() {
 		if (!this.called.json) {
 			this.called.json = true;
-			let data = normalizeSerializableData(this.data());
-			if (!Array.isArray(data) && data && typeof data.data !== "undefined") data = data.data;
-			data = sanitizeConditionalAttributes(data);
-			const caseStyle = this.resolveSerializerCaseStyle(this.constructor);
-			if (caseStyle) {
-				const transformer = getCaseTransformer(caseStyle);
-				data = transformKeys(data, transformer);
-			}
-			const customMeta = this.resolveMergedMeta(Resource.prototype.with);
-			const { wrap, rootKey, factory } = this.resolveResponseStructure();
-			this.body = buildResponseEnvelope({
-				payload: data,
-				wrap,
-				rootKey,
-				factory,
-				context: {
-					type: "resource",
-					resource: this.resource
-				}
+			const ctx = this.resolveSerializationContext();
+			const resource = this.data(ctx);
+			if (this.isPromiseLike(resource)) this.serializationPromise = Promise.resolve(resource).then((resolved) => {
+				this.serializeResource(resolved);
 			});
-			this.body = appendRootProperties(this.body, customMeta, rootKey);
-			this.body = this.applySerializePlugins(this.body);
+			else this.serializeResource(resource);
 		}
 		return this;
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resora",
-  "version": "1.2.12",
+  "version": "1.3.1",
   "description": "A structured API response layer for Node.js and TypeScript with automatic JSON responses, collection support, and pagination handling.",
   "keywords": [
     "api",