feat: transform page promise

Author: vis97c

packages/common-types/src/fetch.ts

@@ -45,4 +45,4 @@ export type tHydrate<T> = (c: T, e?: unknown) => void;
 
 export type iGetPage<T, C extends string | number = string> = (
 	params?: iPagination
-) => Promise<iPage<T, C>>;
+) => Promise<iPage<T, C> | undefined>;

packages/components-vue/src/components/form/Stages.vue

@@ -134,7 +134,6 @@
 		 */
 		submitLabel?: string;
 		stages?: iForm[][];
-		showConformity?: boolean;
 		hideRequiredDisclaimer?: boolean;
 		stagesClasses?: tProps<string>;
 		/**

packages/components-vue/src/components/loader/ContentFetch.vue

@@ -124,9 +124,7 @@
 
 				// success, clear errors
 				errors.value = undefined;
-			} else {
-				throw new Error("No data source url or promise provided");
-			}
+			} else console.warn("No data source url or promise provided");
 		} catch (err) {
 			console.error(err);
 			fetchedContent.value = undefined;

packages/components-vue/src/components/pagination/Content.vue

@@ -1,7 +1,7 @@
 <template>
 	<LoaderContentFetch
 		v-slot="{ content, refresh }"
-		:promise="page"
+		:promise="patchedPromise"
 		:payload="[{ ...pagination, ...defaults }]"
 		v-bind="{ ...$attrs, preventAutoload, theme, label }"
 	>
@@ -21,11 +21,16 @@
 	</LoaderContentFetch>
 </template>
 
-<script setup lang="ts" generic="T, C extends string | number = string">
+<script
+	setup
+	lang="ts"
+	generic="T, C extends string | number = string, R extends any = iPage<T, C>"
+>
 	import { computed, getCurrentInstance, inject, ref } from "vue";
 
 	import type {
 		iGetPage,
+		iPage,
 		iPagination,
 		iPluginOptions,
 		tOrderBy,
@@ -36,13 +41,13 @@
 
 	import type { iUseThemeProps } from "../../types/props";
 
-	export interface iPCProps<Ti, Ci extends string | number = string>
+	export interface iPCProps<Ti, Ci extends string | number = string, Ri = iPage<Ti, Ci>>
 		extends iPagination,
 			iUseThemeProps {
 		/**
 		 * Function used to fetch the page
 		 */
-		page: iGetPage<Ti, Ci>;
+		page: (params?: iPagination) => Promise<Ri | undefined>;
 		/**
 		 * paginate using route
 		 */
@@ -60,6 +65,10 @@
 		 * Loader label
 		 */
 		label?: string;
+		/**
+		 * When additional operations are required on fetched data
+		 */
+		transform?: (r: Ri) => iPage<Ti, Ci> | undefined;
 	}
 
 	/**
@@ -73,11 +82,20 @@
 
 	defineOptions({ name: "PaginationContent", inheritAttrs: false });
 
-	const props = defineProps<iPCProps<T, C>>();
+	const props = defineProps<iPCProps<T, C, R>>();
 
 	const xamuOptions = inject<iPluginOptions>("xamu");
 	const router = getCurrentInstance()?.appContext.config.globalProperties.$router;
 
+	/**
+	 * Patched promise
+	 */
+	const patchedPromise = computed<iGetPage<T, C>>(() => {
+		const transform: (r: any) => iPage<T, C> | undefined = props.transform || ((v) => v);
+
+		return async (v) => transform(await props.page(v));
+	});
+
 	const propsPagination = ref<iPagination>({
 		orderBy: props.orderBy,
 		first: props.first ?? xamuOptions?.first,