resora 1.3.2 → 1.3.4

package/dist/index.cjs

@@ -436,17 +436,17 @@ const mergeMetadata = (base, incoming) => {
 //#endregion
 //#region src/utilities/arkorm.ts
 /**
-* Type guard to check if a value is an Arkorm-like model, which is defined as an object 
-* that has a toObject method and optionally getRawAttributes, getAttribute, and 
-* setAttribute methods.
+* Type guard to check if a value is an Arkorm-like model.
+*
+* Arkorm models expose `toObject()`. Some production model variants/proxies do
+* not expose `getRawAttributes()`, so the serializer should not require it.
 * 
 * @param value  The value to check
 * @returns True if the value is an Arkorm-like model, false otherwise
 */
 const isArkormLikeModel = (value) => {
 	if (!value || typeof value !== "object") return false;
-	const candidate = value;
-	return typeof candidate.toObject === "function" && typeof candidate.getRawAttributes === "function";
+	return typeof value.toObject === "function";
 };
 /**
 * Type guard to check if a value is an Arkorm-like collection, which is defined as an object
@@ -491,6 +491,30 @@ const normalizeSerializableData = (value) => {
 	}, {});
 	return value;
 };
+const isPromiseLike = (value) => {
+	return !!value && (typeof value === "object" || typeof value === "function") && typeof value.then === "function";
+};
+/**
+* Async variant of normalizeSerializableData. It resolves promise-like values at
+* every nesting level before converting Arkorm-like models and collections.
+*
+* @param value The value to normalize
+* @returns The normalized value, ready for serialization
+*/
+const normalizeSerializableDataAsync = async (value) => {
+	const resolvedValue = isPromiseLike(value) ? await value : value;
+	if (Array.isArray(resolvedValue)) return Promise.all(resolvedValue.map((item) => normalizeSerializableDataAsync(item)));
+	if (isResoraCollectionLike(resolvedValue)) return normalizeSerializableDataAsync(resolvedValue.toObject());
+	if (isArkormLikeModel(resolvedValue)) return normalizeSerializableDataAsync(resolvedValue.toObject());
+	if (isArkormLikeCollection(resolvedValue)) return normalizeSerializableDataAsync(resolvedValue.all());
+	if (isPlainObject(resolvedValue)) return (await Promise.all(Object.entries(resolvedValue).map(async ([key, nestedValue]) => {
+		return [key, await normalizeSerializableDataAsync(nestedValue)];
+	}))).reduce((accumulator, [key, nestedValue]) => {
+		accumulator[key] = nestedValue;
+		return accumulator;
+	}, {});
+	return resolvedValue;
+};
 
 //#endregion
 //#region src/utilities/pagination.ts
@@ -1901,6 +1925,48 @@ var GenericResource = class GenericResource extends BaseSerializer {
 		}
 		serialize(data);
 	}
+	async serializeGenericResourceAsync(resource, ctx) {
+		let data = await normalizeSerializableDataAsync(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);
+			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(GenericResource.prototype.with);
+			const { wrap, rootKey, factory } = this.resolveResponseStructure();
+			this.body = buildResponseEnvelope({
+				payload: data,
+				meta: configuredMeta,
+				metaKey,
+				wrap,
+				rootKey,
+				factory,
+				context: {
+					type: "generic",
+					resource: this.resource
+				}
+			});
+			this.body = appendRootProperties(this.body, {
+				...paginationExtras,
+				...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));
+			data = await Promise.all(collected);
+			data = await normalizeSerializableDataAsync(data);
+		}
+		serialize(data);
+	}
 	/**
 	* Convert resource to JSON response format
 	* 
@@ -1912,8 +1978,7 @@ var GenericResource = class GenericResource extends BaseSerializer {
 			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;
+				return this.serializeGenericResourceAsync(resolved, ctx);
 			});
 			else {
 				const result = this.serializeGenericResource(resource, ctx);
@@ -2244,6 +2309,38 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 		}, rootKey);
 		this.body = this.applySerializePlugins(this.body);
 	}
+	async serializeCollectionDataAsync(items) {
+		let data = await normalizeSerializableDataAsync(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));
@@ -2265,11 +2362,16 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 			const serialize = (items) => {
 				const resolvedData = this.resolveCollectionDataForSerialization(items, ctx);
 				if (this.isPromiseLike(resolvedData)) return resolvedData.then((resolved) => {
-					this.serializeCollectionData(resolved);
+					return this.serializeCollectionDataAsync(resolved);
 				});
 				this.serializeCollectionData(resolvedData);
 			};
-			if (this.isPromiseLike(data)) this.serializationPromise = Promise.resolve(data).then(serialize);
+			if (this.isPromiseLike(data)) this.serializationPromise = Promise.resolve(data).then((items) => {
+				const resolvedData = this.resolveCollectionDataForSerialization(items, ctx);
+				return Promise.resolve(resolvedData).then((resolved) => {
+					return this.serializeCollectionDataAsync(resolved);
+				});
+			});
 			else {
 				const result = serialize(data);
 				if (this.isPromiseLike(result)) this.serializationPromise = Promise.resolve(result);
@@ -2568,6 +2670,30 @@ var Resource = class Resource extends BaseSerializer {
 		this.body = appendRootProperties(this.body, customMeta, rootKey);
 		this.body = this.applySerializePlugins(this.body);
 	}
+	async serializeResourceAsync(resource) {
+		let data = await normalizeSerializableDataAsync(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
 	* 
@@ -2579,7 +2705,7 @@ var Resource = class Resource extends BaseSerializer {
 			const ctx = this.resolveSerializationContext();
 			const resource = this.data(ctx);
 			if (this.isPromiseLike(resource)) this.serializationPromise = Promise.resolve(resource).then((resolved) => {
-				this.serializeResource(resolved);
+				return this.serializeResourceAsync(resolved);
 			});
 			else this.serializeResource(resource);
 		}
@@ -2795,6 +2921,7 @@ exports.isResoraCollectionLike = isResoraCollectionLike;
 exports.loadRuntimeConfig = loadRuntimeConfig;
 exports.mergeMetadata = mergeMetadata;
 exports.normalizeSerializableData = normalizeSerializableData;
+exports.normalizeSerializableDataAsync = normalizeSerializableDataAsync;
 exports.registerPlugin = registerPlugin;
 exports.registerUtility = registerUtility;
 exports.resetPluginsForTests = resetPluginsForTests;

package/dist/index.d.cts

@@ -790,6 +790,7 @@ declare class ResourceCollection<R extends ResourceData[] | Collectible | Collec
    */
   private getPayloadKey;
   private serializeCollectionData;
+  private serializeCollectionDataAsync;
   private resolveCollectionDataForSerialization;
   /**
    * Convert resource to JSON response format
@@ -909,6 +910,7 @@ declare class Resource<R extends ResourceData | NonCollectible = ResourceData> e
   protected getSerializerType(): "resource";
   private getPayloadKey;
   private serializeResource;
+  private serializeResourceAsync;
   /**
    * Convert resource to JSON response format
    *
@@ -1031,6 +1033,7 @@ declare class GenericResource<R extends NonCollectible | Collectible | Collectio
   protected getSerializerType(): "generic";
   private getPayloadKey;
   private serializeGenericResource;
+  private serializeGenericResourceAsync;
   /**
    * Convert resource to JSON response format
    *
@@ -1222,7 +1225,7 @@ declare const defineConfig: (config: ResoraConfig) => Config;
 //#endregion
 //#region src/utilities/arkorm.d.ts
 type ArkormLikeModel = {
-  toObject: () => Record<string, any>;
+  toObject: () => Record<string, any> | PromiseLike<Record<string, any>>;
   getRawAttributes?: () => Record<string, any>;
   getAttribute?: (key: string) => unknown;
   setAttribute?: (key: string, value: unknown) => unknown;
@@ -1237,9 +1240,10 @@ type ResoraCollectionLike = {
   setCollects: (...args: unknown[]) => unknown;
 };
 /**
- * Type guard to check if a value is an Arkorm-like model, which is defined as an object
- * that has a toObject method and optionally getRawAttributes, getAttribute, and
- * setAttribute methods.
+ * Type guard to check if a value is an Arkorm-like model.
+ *
+ * Arkorm models expose `toObject()`. Some production model variants/proxies do
+ * not expose `getRawAttributes()`, so the serializer should not require it.
  *
  * @param value  The value to check
  * @returns True if the value is an Arkorm-like model, false otherwise
@@ -1267,6 +1271,14 @@ declare const isResoraCollectionLike: (value: unknown) => value is ResoraCollect
  * @returns The normalized value, ready for serialization
  */
 declare const normalizeSerializableData: (value: unknown) => unknown;
+/**
+ * Async variant of normalizeSerializableData. It resolves promise-like values at
+ * every nesting level before converting Arkorm-like models and collections.
+ *
+ * @param value The value to normalize
+ * @returns The normalized value, ready for serialization
+ */
+declare const normalizeSerializableDataAsync: (value: unknown) => Promise<unknown>;
 //#endregion
 //#region src/utilities/metadata.d.ts
 /**
@@ -1600,4 +1612,4 @@ declare const extractResponseFromCtx: (ctx: unknown) => any | undefined;
  */
 declare const setCtx: (ctx: unknown) => void;
 //#endregion
-export { ApiResource, CONDITIONAL_ATTRIBUTE_MISSING, CaseStyle, CliApp, Collectible, CollectionBody, CollectionLike, Config, Cursor, GenericBody, GenericResource, InitCommand, MakeResource, MetaData, NonCollectible, PaginatedMetaData, Pagination, PaginatorLike, ResoraConfig, ResoraPlugin, ResoraPluginApi, ResoraPluginUtility, Resource, ResourceBody, ResourceCollection, ResourceData, ResourceDef, ResourceLevelConfig, ResponseData, ResponseDataCollection, ResponseFactory, ResponseFactoryContext, ResponseKind, ResponsePluginEvent, ResponseStructureConfig, SendPluginEvent, SerializePluginEvent, ServerResponse, appendRootProperties, applyRuntimeConfig, buildPaginationExtras, buildResponseEnvelope, createArkormCurrentPageResolver, defineConfig, definePlugin, extractRequestUrl, extractResponseFromCtx, getCaseTransformer, getCtx, getDefaultConfig, getGlobalBaseUrl, getGlobalCase, getGlobalCursorMeta, getGlobalPageName, getGlobalPaginatedExtras, getGlobalPaginatedLinks, getGlobalPaginatedMeta, getGlobalResponseFactory, getGlobalResponseRootKey, getGlobalResponseStructure, getGlobalResponseWrap, getPaginationExtraKeys, getRegisteredPlugins, getRequestUrl, getUtility, hasPaginationLink, isArkormLikeCollection, isArkormLikeModel, isPlainObject, isResoraCollectionLike, loadRuntimeConfig, mergeMetadata, normalizeSerializableData, registerPlugin, registerUtility, resetPluginsForTests, resetRuntimeConfigForTests, resolveCurrentPage, resolveMergeWhen, resolveWhen, resolveWhenNotNull, resolveWithHookMetadata, runPluginHook, runWithCtx, sanitizeConditionalAttributes, setCtx, setGlobalBaseUrl, setGlobalCase, setGlobalCursorMeta, setGlobalPageName, setGlobalPaginatedExtras, setGlobalPaginatedLinks, setGlobalPaginatedMeta, setGlobalResponseFactory, setGlobalResponseRootKey, setGlobalResponseStructure, setGlobalResponseWrap, setRequestUrl, splitWords, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, transformKeys };
+export { ApiResource, CONDITIONAL_ATTRIBUTE_MISSING, CaseStyle, CliApp, Collectible, CollectionBody, CollectionLike, Config, Cursor, GenericBody, GenericResource, InitCommand, MakeResource, MetaData, NonCollectible, PaginatedMetaData, Pagination, PaginatorLike, ResoraConfig, ResoraPlugin, ResoraPluginApi, ResoraPluginUtility, Resource, ResourceBody, ResourceCollection, ResourceData, ResourceDef, ResourceLevelConfig, ResponseData, ResponseDataCollection, ResponseFactory, ResponseFactoryContext, ResponseKind, ResponsePluginEvent, ResponseStructureConfig, SendPluginEvent, SerializePluginEvent, ServerResponse, appendRootProperties, applyRuntimeConfig, buildPaginationExtras, buildResponseEnvelope, createArkormCurrentPageResolver, defineConfig, definePlugin, extractRequestUrl, extractResponseFromCtx, getCaseTransformer, getCtx, getDefaultConfig, getGlobalBaseUrl, getGlobalCase, getGlobalCursorMeta, getGlobalPageName, getGlobalPaginatedExtras, getGlobalPaginatedLinks, getGlobalPaginatedMeta, getGlobalResponseFactory, getGlobalResponseRootKey, getGlobalResponseStructure, getGlobalResponseWrap, getPaginationExtraKeys, getRegisteredPlugins, getRequestUrl, getUtility, hasPaginationLink, isArkormLikeCollection, isArkormLikeModel, isPlainObject, isResoraCollectionLike, loadRuntimeConfig, mergeMetadata, normalizeSerializableData, normalizeSerializableDataAsync, registerPlugin, registerUtility, resetPluginsForTests, resetRuntimeConfigForTests, resolveCurrentPage, resolveMergeWhen, resolveWhen, resolveWhenNotNull, resolveWithHookMetadata, runPluginHook, runWithCtx, sanitizeConditionalAttributes, setCtx, setGlobalBaseUrl, setGlobalCase, setGlobalCursorMeta, setGlobalPageName, setGlobalPaginatedExtras, setGlobalPaginatedLinks, setGlobalPaginatedMeta, setGlobalResponseFactory, setGlobalResponseRootKey, setGlobalResponseStructure, setGlobalResponseWrap, setRequestUrl, splitWords, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, transformKeys };

package/dist/index.d.mts

@@ -790,6 +790,7 @@ declare class ResourceCollection<R extends ResourceData[] | Collectible | Collec
    */
   private getPayloadKey;
   private serializeCollectionData;
+  private serializeCollectionDataAsync;
   private resolveCollectionDataForSerialization;
   /**
    * Convert resource to JSON response format
@@ -909,6 +910,7 @@ declare class Resource<R extends ResourceData | NonCollectible = ResourceData> e
   protected getSerializerType(): "resource";
   private getPayloadKey;
   private serializeResource;
+  private serializeResourceAsync;
   /**
    * Convert resource to JSON response format
    *
@@ -1031,6 +1033,7 @@ declare class GenericResource<R extends NonCollectible | Collectible | Collectio
   protected getSerializerType(): "generic";
   private getPayloadKey;
   private serializeGenericResource;
+  private serializeGenericResourceAsync;
   /**
    * Convert resource to JSON response format
    *
@@ -1222,7 +1225,7 @@ declare const defineConfig: (config: ResoraConfig) => Config;
 //#endregion
 //#region src/utilities/arkorm.d.ts
 type ArkormLikeModel = {
-  toObject: () => Record<string, any>;
+  toObject: () => Record<string, any> | PromiseLike<Record<string, any>>;
   getRawAttributes?: () => Record<string, any>;
   getAttribute?: (key: string) => unknown;
   setAttribute?: (key: string, value: unknown) => unknown;
@@ -1237,9 +1240,10 @@ type ResoraCollectionLike = {
   setCollects: (...args: unknown[]) => unknown;
 };
 /**
- * Type guard to check if a value is an Arkorm-like model, which is defined as an object
- * that has a toObject method and optionally getRawAttributes, getAttribute, and
- * setAttribute methods.
+ * Type guard to check if a value is an Arkorm-like model.
+ *
+ * Arkorm models expose `toObject()`. Some production model variants/proxies do
+ * not expose `getRawAttributes()`, so the serializer should not require it.
  *
  * @param value  The value to check
  * @returns True if the value is an Arkorm-like model, false otherwise
@@ -1267,6 +1271,14 @@ declare const isResoraCollectionLike: (value: unknown) => value is ResoraCollect
  * @returns The normalized value, ready for serialization
  */
 declare const normalizeSerializableData: (value: unknown) => unknown;
+/**
+ * Async variant of normalizeSerializableData. It resolves promise-like values at
+ * every nesting level before converting Arkorm-like models and collections.
+ *
+ * @param value The value to normalize
+ * @returns The normalized value, ready for serialization
+ */
+declare const normalizeSerializableDataAsync: (value: unknown) => Promise<unknown>;
 //#endregion
 //#region src/utilities/metadata.d.ts
 /**
@@ -1600,4 +1612,4 @@ declare const extractResponseFromCtx: (ctx: unknown) => any | undefined;
  */
 declare const setCtx: (ctx: unknown) => void;
 //#endregion
-export { ApiResource, CONDITIONAL_ATTRIBUTE_MISSING, CaseStyle, CliApp, Collectible, CollectionBody, CollectionLike, Config, Cursor, GenericBody, GenericResource, InitCommand, MakeResource, MetaData, NonCollectible, PaginatedMetaData, Pagination, PaginatorLike, ResoraConfig, ResoraPlugin, ResoraPluginApi, ResoraPluginUtility, Resource, ResourceBody, ResourceCollection, ResourceData, ResourceDef, ResourceLevelConfig, ResponseData, ResponseDataCollection, ResponseFactory, ResponseFactoryContext, ResponseKind, ResponsePluginEvent, ResponseStructureConfig, SendPluginEvent, SerializePluginEvent, ServerResponse, appendRootProperties, applyRuntimeConfig, buildPaginationExtras, buildResponseEnvelope, createArkormCurrentPageResolver, defineConfig, definePlugin, extractRequestUrl, extractResponseFromCtx, getCaseTransformer, getCtx, getDefaultConfig, getGlobalBaseUrl, getGlobalCase, getGlobalCursorMeta, getGlobalPageName, getGlobalPaginatedExtras, getGlobalPaginatedLinks, getGlobalPaginatedMeta, getGlobalResponseFactory, getGlobalResponseRootKey, getGlobalResponseStructure, getGlobalResponseWrap, getPaginationExtraKeys, getRegisteredPlugins, getRequestUrl, getUtility, hasPaginationLink, isArkormLikeCollection, isArkormLikeModel, isPlainObject, isResoraCollectionLike, loadRuntimeConfig, mergeMetadata, normalizeSerializableData, registerPlugin, registerUtility, resetPluginsForTests, resetRuntimeConfigForTests, resolveCurrentPage, resolveMergeWhen, resolveWhen, resolveWhenNotNull, resolveWithHookMetadata, runPluginHook, runWithCtx, sanitizeConditionalAttributes, setCtx, setGlobalBaseUrl, setGlobalCase, setGlobalCursorMeta, setGlobalPageName, setGlobalPaginatedExtras, setGlobalPaginatedLinks, setGlobalPaginatedMeta, setGlobalResponseFactory, setGlobalResponseRootKey, setGlobalResponseStructure, setGlobalResponseWrap, setRequestUrl, splitWords, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, transformKeys };
+export { ApiResource, CONDITIONAL_ATTRIBUTE_MISSING, CaseStyle, CliApp, Collectible, CollectionBody, CollectionLike, Config, Cursor, GenericBody, GenericResource, InitCommand, MakeResource, MetaData, NonCollectible, PaginatedMetaData, Pagination, PaginatorLike, ResoraConfig, ResoraPlugin, ResoraPluginApi, ResoraPluginUtility, Resource, ResourceBody, ResourceCollection, ResourceData, ResourceDef, ResourceLevelConfig, ResponseData, ResponseDataCollection, ResponseFactory, ResponseFactoryContext, ResponseKind, ResponsePluginEvent, ResponseStructureConfig, SendPluginEvent, SerializePluginEvent, ServerResponse, appendRootProperties, applyRuntimeConfig, buildPaginationExtras, buildResponseEnvelope, createArkormCurrentPageResolver, defineConfig, definePlugin, extractRequestUrl, extractResponseFromCtx, getCaseTransformer, getCtx, getDefaultConfig, getGlobalBaseUrl, getGlobalCase, getGlobalCursorMeta, getGlobalPageName, getGlobalPaginatedExtras, getGlobalPaginatedLinks, getGlobalPaginatedMeta, getGlobalResponseFactory, getGlobalResponseRootKey, getGlobalResponseStructure, getGlobalResponseWrap, getPaginationExtraKeys, getRegisteredPlugins, getRequestUrl, getUtility, hasPaginationLink, isArkormLikeCollection, isArkormLikeModel, isPlainObject, isResoraCollectionLike, loadRuntimeConfig, mergeMetadata, normalizeSerializableData, normalizeSerializableDataAsync, registerPlugin, registerUtility, resetPluginsForTests, resetRuntimeConfigForTests, resolveCurrentPage, resolveMergeWhen, resolveWhen, resolveWhenNotNull, resolveWithHookMetadata, runPluginHook, runWithCtx, sanitizeConditionalAttributes, setCtx, setGlobalBaseUrl, setGlobalCase, setGlobalCursorMeta, setGlobalPageName, setGlobalPaginatedExtras, setGlobalPaginatedLinks, setGlobalPaginatedMeta, setGlobalResponseFactory, setGlobalResponseRootKey, setGlobalResponseStructure, setGlobalResponseWrap, setRequestUrl, splitWords, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, transformKeys };

package/dist/index.mjs

@@ -407,17 +407,17 @@ const mergeMetadata = (base, incoming) => {
 //#endregion
 //#region src/utilities/arkorm.ts
 /**
-* Type guard to check if a value is an Arkorm-like model, which is defined as an object 
-* that has a toObject method and optionally getRawAttributes, getAttribute, and 
-* setAttribute methods.
+* Type guard to check if a value is an Arkorm-like model.
+*
+* Arkorm models expose `toObject()`. Some production model variants/proxies do
+* not expose `getRawAttributes()`, so the serializer should not require it.
 * 
 * @param value  The value to check
 * @returns True if the value is an Arkorm-like model, false otherwise
 */
 const isArkormLikeModel = (value) => {
 	if (!value || typeof value !== "object") return false;
-	const candidate = value;
-	return typeof candidate.toObject === "function" && typeof candidate.getRawAttributes === "function";
+	return typeof value.toObject === "function";
 };
 /**
 * Type guard to check if a value is an Arkorm-like collection, which is defined as an object
@@ -462,6 +462,30 @@ const normalizeSerializableData = (value) => {
 	}, {});
 	return value;
 };
+const isPromiseLike = (value) => {
+	return !!value && (typeof value === "object" || typeof value === "function") && typeof value.then === "function";
+};
+/**
+* Async variant of normalizeSerializableData. It resolves promise-like values at
+* every nesting level before converting Arkorm-like models and collections.
+*
+* @param value The value to normalize
+* @returns The normalized value, ready for serialization
+*/
+const normalizeSerializableDataAsync = async (value) => {
+	const resolvedValue = isPromiseLike(value) ? await value : value;
+	if (Array.isArray(resolvedValue)) return Promise.all(resolvedValue.map((item) => normalizeSerializableDataAsync(item)));
+	if (isResoraCollectionLike(resolvedValue)) return normalizeSerializableDataAsync(resolvedValue.toObject());
+	if (isArkormLikeModel(resolvedValue)) return normalizeSerializableDataAsync(resolvedValue.toObject());
+	if (isArkormLikeCollection(resolvedValue)) return normalizeSerializableDataAsync(resolvedValue.all());
+	if (isPlainObject(resolvedValue)) return (await Promise.all(Object.entries(resolvedValue).map(async ([key, nestedValue]) => {
+		return [key, await normalizeSerializableDataAsync(nestedValue)];
+	}))).reduce((accumulator, [key, nestedValue]) => {
+		accumulator[key] = nestedValue;
+		return accumulator;
+	}, {});
+	return resolvedValue;
+};
 
 //#endregion
 //#region src/utilities/pagination.ts
@@ -1872,6 +1896,48 @@ var GenericResource = class GenericResource extends BaseSerializer {
 		}
 		serialize(data);
 	}
+	async serializeGenericResourceAsync(resource, ctx) {
+		let data = await normalizeSerializableDataAsync(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);
+			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(GenericResource.prototype.with);
+			const { wrap, rootKey, factory } = this.resolveResponseStructure();
+			this.body = buildResponseEnvelope({
+				payload: data,
+				meta: configuredMeta,
+				metaKey,
+				wrap,
+				rootKey,
+				factory,
+				context: {
+					type: "generic",
+					resource: this.resource
+				}
+			});
+			this.body = appendRootProperties(this.body, {
+				...paginationExtras,
+				...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));
+			data = await Promise.all(collected);
+			data = await normalizeSerializableDataAsync(data);
+		}
+		serialize(data);
+	}
 	/**
 	* Convert resource to JSON response format
 	* 
@@ -1883,8 +1949,7 @@ var GenericResource = class GenericResource extends BaseSerializer {
 			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;
+				return this.serializeGenericResourceAsync(resolved, ctx);
 			});
 			else {
 				const result = this.serializeGenericResource(resource, ctx);
@@ -2215,6 +2280,38 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 		}, rootKey);
 		this.body = this.applySerializePlugins(this.body);
 	}
+	async serializeCollectionDataAsync(items) {
+		let data = await normalizeSerializableDataAsync(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));
@@ -2236,11 +2333,16 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 			const serialize = (items) => {
 				const resolvedData = this.resolveCollectionDataForSerialization(items, ctx);
 				if (this.isPromiseLike(resolvedData)) return resolvedData.then((resolved) => {
-					this.serializeCollectionData(resolved);
+					return this.serializeCollectionDataAsync(resolved);
 				});
 				this.serializeCollectionData(resolvedData);
 			};
-			if (this.isPromiseLike(data)) this.serializationPromise = Promise.resolve(data).then(serialize);
+			if (this.isPromiseLike(data)) this.serializationPromise = Promise.resolve(data).then((items) => {
+				const resolvedData = this.resolveCollectionDataForSerialization(items, ctx);
+				return Promise.resolve(resolvedData).then((resolved) => {
+					return this.serializeCollectionDataAsync(resolved);
+				});
+			});
 			else {
 				const result = serialize(data);
 				if (this.isPromiseLike(result)) this.serializationPromise = Promise.resolve(result);
@@ -2539,6 +2641,30 @@ var Resource = class Resource extends BaseSerializer {
 		this.body = appendRootProperties(this.body, customMeta, rootKey);
 		this.body = this.applySerializePlugins(this.body);
 	}
+	async serializeResourceAsync(resource) {
+		let data = await normalizeSerializableDataAsync(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
 	* 
@@ -2550,7 +2676,7 @@ var Resource = class Resource extends BaseSerializer {
 			const ctx = this.resolveSerializationContext();
 			const resource = this.data(ctx);
 			if (this.isPromiseLike(resource)) this.serializationPromise = Promise.resolve(resource).then((resolved) => {
-				this.serializeResource(resolved);
+				return this.serializeResourceAsync(resolved);
 			});
 			else this.serializeResource(resource);
 		}
@@ -2722,4 +2848,4 @@ var Resource = class Resource extends BaseSerializer {
 };
 
 //#endregion
-export { ApiResource, CONDITIONAL_ATTRIBUTE_MISSING, CliApp, GenericResource, InitCommand, MakeResource, Resource, ResourceCollection, ServerResponse, appendRootProperties, applyRuntimeConfig, buildPaginationExtras, buildResponseEnvelope, createArkormCurrentPageResolver, defineConfig, definePlugin, extractRequestUrl, extractResponseFromCtx, getCaseTransformer, getCtx, getDefaultConfig, getGlobalBaseUrl, getGlobalCase, getGlobalCursorMeta, getGlobalPageName, getGlobalPaginatedExtras, getGlobalPaginatedLinks, getGlobalPaginatedMeta, getGlobalResponseFactory, getGlobalResponseRootKey, getGlobalResponseStructure, getGlobalResponseWrap, getPaginationExtraKeys, getRegisteredPlugins, getRequestUrl, getUtility, hasPaginationLink, isArkormLikeCollection, isArkormLikeModel, isPlainObject, isResoraCollectionLike, loadRuntimeConfig, mergeMetadata, normalizeSerializableData, registerPlugin, registerUtility, resetPluginsForTests, resetRuntimeConfigForTests, resolveCurrentPage, resolveMergeWhen, resolveWhen, resolveWhenNotNull, resolveWithHookMetadata, runPluginHook, runWithCtx, sanitizeConditionalAttributes, setCtx, setGlobalBaseUrl, setGlobalCase, setGlobalCursorMeta, setGlobalPageName, setGlobalPaginatedExtras, setGlobalPaginatedLinks, setGlobalPaginatedMeta, setGlobalResponseFactory, setGlobalResponseRootKey, setGlobalResponseStructure, setGlobalResponseWrap, setRequestUrl, splitWords, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, transformKeys };
+export { ApiResource, CONDITIONAL_ATTRIBUTE_MISSING, CliApp, GenericResource, InitCommand, MakeResource, Resource, ResourceCollection, ServerResponse, appendRootProperties, applyRuntimeConfig, buildPaginationExtras, buildResponseEnvelope, createArkormCurrentPageResolver, defineConfig, definePlugin, extractRequestUrl, extractResponseFromCtx, getCaseTransformer, getCtx, getDefaultConfig, getGlobalBaseUrl, getGlobalCase, getGlobalCursorMeta, getGlobalPageName, getGlobalPaginatedExtras, getGlobalPaginatedLinks, getGlobalPaginatedMeta, getGlobalResponseFactory, getGlobalResponseRootKey, getGlobalResponseStructure, getGlobalResponseWrap, getPaginationExtraKeys, getRegisteredPlugins, getRequestUrl, getUtility, hasPaginationLink, isArkormLikeCollection, isArkormLikeModel, isPlainObject, isResoraCollectionLike, loadRuntimeConfig, mergeMetadata, normalizeSerializableData, normalizeSerializableDataAsync, registerPlugin, registerUtility, resetPluginsForTests, resetRuntimeConfigForTests, resolveCurrentPage, resolveMergeWhen, resolveWhen, resolveWhenNotNull, resolveWithHookMetadata, runPluginHook, runWithCtx, sanitizeConditionalAttributes, setCtx, setGlobalBaseUrl, setGlobalCase, setGlobalCursorMeta, setGlobalPageName, setGlobalPaginatedExtras, setGlobalPaginatedLinks, setGlobalPaginatedMeta, setGlobalResponseFactory, setGlobalResponseRootKey, setGlobalResponseStructure, setGlobalResponseWrap, setRequestUrl, splitWords, toCamelCase, toKebabCase, toPascalCase, toSnakeCase, transformKeys };

package/package.json

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