@htlkg/data 0.0.21 → 0.0.22

package/src/hooks/index.ts

@@ -2,6 +2,7 @@
  * Data Hooks for @htlkg/data
  *
  * Vue composables for fetching and managing data with reactive state.
+ * Organized by entity type in subfolders for better maintainability.
  */
 
 // Hook factory for creating custom data hooks
@@ -14,11 +15,98 @@ export {
 	type InferHookReturn,
 } from "./createDataHook";
 
-// Pre-built hooks for common models
-export { useBrands, type UseBrandsOptions, type UseBrandsReturn } from "./useBrands";
-export { useAccounts, type UseAccountsOptions, type UseAccountsReturn } from "./useAccounts";
-export { useUsers, type UseUsersOptions, type UseUsersReturn } from "./useUsers";
-export { useProducts, type UseProductsOptions, type UseProductsReturn } from "./useProducts";
-export { useProductInstances, type UseProductInstancesOptions, type UseProductInstancesReturn } from "./useProductInstances";
-export { useReservations, type UseReservationsOptions, type UseReservationsReturn } from "./useReservations";
-export { useContacts, type UseContactsOptions, type UseContactsReturn } from "./useContacts";
+// Paginated hook factory for large datasets
+export {
+	createPaginatedDataHook,
+	ACTIVE_FILTER,
+	DELETED_FILTER,
+	type CreatePaginatedDataHookOptions,
+	type PaginatedHookOptions,
+	type PaginationState,
+	type PaginatedDataHookReturn,
+	type InferPaginatedHookReturn,
+} from "./createPaginatedDataHook";
+
+// ============================================
+// BRAND HOOKS
+// ============================================
+export {
+	useBrands,
+	useActiveBrands,
+	useDeletedBrands,
+	type UseBrandsOptions,
+	type UseBrandsReturn,
+	type BrandWithCounts,
+	type UsePaginatedBrandsOptions,
+	type UsePaginatedBrandsReturn,
+} from "./brands";
+
+// ============================================
+// USER HOOKS
+// ============================================
+export {
+	useUsers,
+	useActiveUsers,
+	useDeletedUsers,
+	type UseUsersOptions,
+	type UseUsersReturn,
+	type UserWithRelations,
+	type UsePaginatedUsersOptions,
+	type UsePaginatedUsersReturn,
+} from "./users";
+
+// ============================================
+// ACCOUNT HOOKS
+// ============================================
+export {
+	useAccounts,
+	useActiveAccounts,
+	useDeletedAccounts,
+	type UseAccountsOptions,
+	type UseAccountsReturn,
+	type AccountWithBrands,
+	type AccountWithBrands as PaginatedAccountWithBrands,
+	type UsePaginatedAccountsOptions,
+	type UsePaginatedAccountsReturn,
+} from "./accounts";
+
+// ============================================
+// RESERVATION HOOKS
+// ============================================
+export {
+	useReservations,
+	useActiveReservations,
+	useDeletedReservations,
+	type UseReservationsOptions,
+	type UseReservationsReturn,
+	type ReservationWithRelations,
+	type UsePaginatedReservationsOptions,
+	type UsePaginatedReservationsReturn,
+} from "./reservations";
+
+// ============================================
+// PRODUCT HOOKS
+// ============================================
+export {
+	useProducts,
+	type UseProductsOptions,
+	type UseProductsReturn,
+} from "./products";
+
+// ============================================
+// PRODUCT INSTANCE HOOKS
+// ============================================
+export {
+	useProductInstances,
+	type UseProductInstancesOptions,
+	type UseProductInstancesReturn,
+} from "./productInstances";
+
+// ============================================
+// CONTACT HOOKS
+// ============================================
+export {
+	useContacts,
+	type UseContactsOptions,
+	type UseContactsReturn,
+} from "./useContacts";

package/src/hooks/productInstances/index.ts

@@ -0,0 +1 @@
+export * from "./useProductInstances";

package/src/hooks/{useProductInstances.ts → productInstances/useProductInstances.ts}

@@ -1,14 +1,14 @@
 /**
- * useProductInstances Hook
+ * ProductInstance Hooks
  *
- * Vue composable for fetching and managing product instance data with reactive state.
+ * Vue composables for fetching and managing product instance data with reactive state.
  * Provides loading states, error handling, refetch capabilities, and CRUD operations.
  */
 
 import type { Ref, ComputedRef } from "vue";
 import type { ProductInstance } from "@htlkg/core/types";
-import { createDataHook, type BaseHookOptions } from "./createDataHook";
-import { getSharedClient } from "../client";
+import { createDataHook, type BaseHookOptions } from "../createDataHook";
+import { getSharedClient } from "../../client";
 import {
 	createProductInstance,
 	updateProductInstance,
@@ -16,7 +16,7 @@ import {
 	toggleProductInstanceEnabled,
 	type CreateProductInstanceInput,
 	type UpdateProductInstanceInput,
-} from "../mutations/productInstances";
+} from "../../mutations/productInstances";
 
 export interface UseProductInstancesOptions extends BaseHookOptions {
 	/** Filter criteria for product instances */
@@ -102,7 +102,7 @@ const useProductInstancesInternal = createDataHook<
  *
  * @example
  * ```typescript
- * import { useProductInstances } from '@htlkg/data/hooks';
+ * import { useProductInstances } from '@htlkg/data/hooks/productInstances';
  *
  * const { instances, loading, error, refetch } = useProductInstances();
  * ```
@@ -172,3 +172,6 @@ export function useProductInstances(options: UseProductInstancesOptions = {}): U
 		toggleEnabled,
 	};
 }
+
+// Re-export types for convenience
+export type { CreateProductInstanceInput, UpdateProductInstanceInput };

package/src/hooks/products/index.ts

@@ -0,0 +1 @@
+export * from "./useProducts";

package/src/hooks/{useProducts.ts → products/useProducts.ts}

@@ -1,13 +1,12 @@
 /**
- * useProducts Hook
+ * Product Hooks
  *
- * Vue composable for fetching and managing product data with reactive state.
- * Provides loading states, error handling, and refetch capabilities.
+ * Vue composables for fetching and managing product data with reactive state.
  */
 
 import type { Ref, ComputedRef } from "vue";
 import type { Product } from "@htlkg/core/types";
-import { createDataHook, type BaseHookOptions } from "./createDataHook";
+import { createDataHook, type BaseHookOptions } from "../createDataHook";
 
 export interface UseProductsOptions extends BaseHookOptions {
 	/** Filter criteria for products */
@@ -63,7 +62,7 @@ const useProductsInternal = createDataHook<Product, UseProductsOptions, { active
  *
  * @example
  * ```typescript
- * import { useProducts } from '@htlkg/data/hooks';
+ * import { useProducts } from '@htlkg/data/hooks/products';
  *
  * const { products, loading, error, refetch } = useProducts();
  * ```

package/src/hooks/reservations/index.ts

@@ -0,0 +1,2 @@
+export * from "./useReservations";
+export * from "./usePaginatedReservations";

package/src/hooks/reservations/usePaginatedReservations.ts

@@ -0,0 +1,258 @@
+/**
+ * Paginated Reservations Hooks
+ *
+ * Vue composables for fetching reservations with server-side pagination.
+ * Provides separate hooks for active and deleted reservations to enable
+ * efficient tab-based filtering in large datasets.
+ */
+
+import type { Ref, ComputedRef } from "vue";
+import type { Reservation } from "../../queries/reservations";
+import {
+	createPaginatedDataHook,
+	ACTIVE_FILTER,
+	DELETED_FILTER,
+	type PaginatedHookOptions,
+	type PaginationState,
+} from "../createPaginatedDataHook";
+import type { ReservationWithRelations } from "./useReservations";
+
+export interface UsePaginatedReservationsOptions extends PaginatedHookOptions {
+	/** Filter by brand ID */
+	brandId?: string;
+	/** Filter by start date (check-in date >= startDate) */
+	startDate?: string;
+	/** Filter by end date (check-in date <= endDate) */
+	endDate?: string;
+	/** Filter by reservation status */
+	status?: Reservation["status"];
+	/** Filter by contact/visit ID */
+	contactId?: string;
+}
+
+export interface UsePaginatedReservationsReturn {
+	/** Reactive array of reservations with brand and guest info */
+	reservations: Ref<ReservationWithRelations[]>;
+	/** Loading state (true during any fetch) */
+	loading: Ref<boolean>;
+	/** Loading state for initial fetch */
+	initialLoading: Ref<boolean>;
+	/** Loading state for loadMore */
+	loadingMore: Ref<boolean>;
+	/** Error state */
+	error: Ref<Error | null>;
+	/** Pagination state */
+	pagination: Ref<PaginationState>;
+	/** Whether there are more items to load */
+	hasMore: ComputedRef<boolean>;
+	/** Load next page of data */
+	loadMore: () => Promise<void>;
+	/** Refetch data (resets to first page) */
+	refetch: () => Promise<void>;
+	/** Reset data and pagination state */
+	reset: () => void;
+	/** Update search filter and refetch from server (searches ALL data) */
+	setSearchFilter: (filter: any) => Promise<void>;
+	/** Current search filter */
+	searchFilter: Ref<any>;
+}
+
+/**
+ * Build additional filter from hook options
+ */
+function buildFilter(options: UsePaginatedReservationsOptions): any {
+	const conditions: any[] = [];
+
+	if (options.brandId) {
+		conditions.push({ brandId: { eq: options.brandId } });
+	}
+
+	if (options.status) {
+		conditions.push({ status: { eq: options.status } });
+	}
+
+	if (options.contactId) {
+		conditions.push({ visitId: { eq: options.contactId } });
+	}
+
+	if (options.startDate) {
+		conditions.push({ checkIn: { ge: options.startDate } });
+	}
+
+	if (options.endDate) {
+		conditions.push({ checkIn: { le: options.endDate } });
+	}
+
+	if (options.filter && Object.keys(options.filter).length > 0) {
+		conditions.push(options.filter);
+	}
+
+	if (conditions.length === 0) {
+		return undefined;
+	}
+	if (conditions.length === 1) {
+		return conditions[0];
+	}
+	return { and: conditions };
+}
+
+/**
+ * Transform reservation data to include brandName and guest info from visit.snapshot
+ */
+function transformReservation(r: any): ReservationWithRelations {
+	// Parse snapshot if it's a string (handles double-stringification from import)
+	let snapshot = r.visit?.snapshot;
+	if (typeof snapshot === "string") {
+		try {
+			snapshot = JSON.parse(snapshot);
+		} catch {
+			snapshot = null;
+		}
+	}
+
+	return {
+		...r,
+		brandName: r.brand?.name || "Unknown Brand",
+		guestName: snapshot
+			? `${snapshot.firstName || ""} ${snapshot.lastName || ""}`.trim() || "Unknown Guest"
+			: "Unknown Guest",
+		guestEmail: snapshot?.email || "",
+		guestPhone: snapshot?.phone || "",
+	};
+}
+
+/**
+ * Selection set for reservation queries
+ */
+const RESERVATION_SELECTION_SET = [
+	"id",
+	"brandId",
+	"visitId",
+	"checkIn",
+	"checkOut",
+	"room",
+	"roomType",
+	"status",
+	"source",
+	"channel",
+	"confirmationCode",
+	"totalAmount",
+	"currency",
+	"nights",
+	"deletedAt",
+	"deletedBy",
+	"brand.name",
+	"visit.snapshot",
+];
+
+/**
+ * Internal hook for active reservations
+ */
+const useActiveReservationsInternal = createPaginatedDataHook<
+	ReservationWithRelations,
+	UsePaginatedReservationsOptions
+>({
+	model: "Reservation",
+	dataPropertyName: "reservations",
+	defaultPageSize: 25,
+	selectionSet: RESERVATION_SELECTION_SET,
+	transform: transformReservation,
+	buildFilter,
+	baseFilter: ACTIVE_FILTER,
+});
+
+/**
+ * Internal hook for deleted reservations
+ */
+const useDeletedReservationsInternal = createPaginatedDataHook<
+	ReservationWithRelations,
+	UsePaginatedReservationsOptions
+>({
+	model: "Reservation",
+	dataPropertyName: "reservations",
+	defaultPageSize: 25,
+	selectionSet: RESERVATION_SELECTION_SET,
+	transform: transformReservation,
+	buildFilter,
+	baseFilter: DELETED_FILTER,
+});
+
+/**
+ * Composable for fetching active (non-deleted) reservations with pagination
+ *
+ * @example
+ * ```typescript
+ * import { useActiveReservations } from '@htlkg/data/hooks';
+ *
+ * const { reservations, loading, hasMore, loadMore, refetch } = useActiveReservations({
+ *   pageSize: 25,
+ *   brandId: 'brand-123',
+ * });
+ *
+ * // Load more when user scrolls or clicks "Load More"
+ * async function onLoadMore() {
+ *   await loadMore();
+ * }
+ * ```
+ *
+ * @example With date filters
+ * ```typescript
+ * const { reservations, loading } = useActiveReservations({
+ *   brandId: 'brand-123',
+ *   startDate: '2026-01-01',
+ *   endDate: '2026-01-31',
+ *   status: 'confirmed'
+ * });
+ * ```
+ */
+export function useActiveReservations(
+	options: UsePaginatedReservationsOptions = {},
+): UsePaginatedReservationsReturn {
+	const result = useActiveReservationsInternal(options);
+	return {
+		reservations: result.reservations as Ref<ReservationWithRelations[]>,
+		loading: result.loading,
+		initialLoading: result.initialLoading,
+		loadingMore: result.loadingMore,
+		error: result.error,
+		pagination: result.pagination,
+		hasMore: result.hasMore,
+		loadMore: result.loadMore,
+		refetch: result.refetch,
+		reset: result.reset,
+		setSearchFilter: result.setSearchFilter,
+		searchFilter: result.searchFilter,
+	};
+}
+
+/**
+ * Composable for fetching deleted reservations with pagination
+ *
+ * @example
+ * ```typescript
+ * import { useDeletedReservations } from '@htlkg/data/hooks';
+ *
+ * const { reservations, loading, hasMore, loadMore, refetch } = useDeletedReservations({
+ *   pageSize: 25,
+ * });
+ * ```
+ */
+export function useDeletedReservations(
+	options: UsePaginatedReservationsOptions = {},
+): UsePaginatedReservationsReturn {
+	const result = useDeletedReservationsInternal(options);
+	return {
+		reservations: result.reservations as Ref<ReservationWithRelations[]>,
+		loading: result.loading,
+		initialLoading: result.initialLoading,
+		loadingMore: result.loadingMore,
+		error: result.error,
+		pagination: result.pagination,
+		hasMore: result.hasMore,
+		loadMore: result.loadMore,
+		refetch: result.refetch,
+		reset: result.reset,
+		setSearchFilter: result.setSearchFilter,
+		searchFilter: result.searchFilter,
+	};
+}

package/src/hooks/{useReservations.ts → reservations/useReservations.ts}

@@ -6,8 +6,8 @@
  */
 
 import type { Ref, ComputedRef } from "vue";
-import type { Reservation } from "../queries/reservations";
-import { createDataHook, type BaseHookOptions } from "./createDataHook";
+import type { Reservation } from "../../queries/reservations";
+import { createDataHook, type BaseHookOptions } from "../createDataHook";
 
 export interface UseReservationsOptions extends BaseHookOptions {
 	/** Filter by brand ID */
@@ -24,13 +24,21 @@ export interface UseReservationsOptions extends BaseHookOptions {
 	nextToken?: string;
 }
 
+/** Extended reservation type with related data */
+export type ReservationWithRelations = Reservation & {
+	brandName: string;
+	guestName: string;
+	guestEmail: string;
+	guestPhone: string;
+};
+
 export interface UseReservationsReturn {
-	/** Reactive array of reservations */
-	reservations: Ref<Reservation[]>;
+	/** Reactive array of reservations with brand and guest info */
+	reservations: Ref<ReservationWithRelations[]>;
 	/** Computed array of confirmed reservations */
-	confirmedReservations: ComputedRef<Reservation[]>;
+	confirmedReservations: ComputedRef<ReservationWithRelations[]>;
 	/** Computed array of active reservations (confirmed or checked_in) */
-	activeReservations: ComputedRef<Reservation[]>;
+	activeReservations: ComputedRef<ReservationWithRelations[]>;
 	/** Loading state */
 	loading: Ref<boolean>;
 	/** Error state */
@@ -80,17 +88,64 @@ function buildFilter(options: UseReservationsOptions): any {
 	return { and: conditions };
 }
 
+/**
+ * Transform reservation data to include brandName and guest info from visit.snapshot
+ */
+function transformReservation(r: any): Reservation & { brandName: string; guestName: string; guestEmail: string; guestPhone: string } {
+	// Parse snapshot if it's a string (handles double-stringification from import)
+	let snapshot = r.visit?.snapshot;
+	if (typeof snapshot === "string") {
+		try {
+			snapshot = JSON.parse(snapshot);
+		} catch {
+			snapshot = null;
+		}
+	}
+
+	return {
+		...r,
+		brandName: r.brand?.name || "Unknown Brand",
+		guestName: snapshot
+			? `${snapshot.firstName || ""} ${snapshot.lastName || ""}`.trim() || "Unknown Guest"
+			: "Unknown Guest",
+		guestEmail: snapshot?.email || "",
+		guestPhone: snapshot?.phone || "",
+	};
+}
+
 /**
  * Internal hook created by factory
  */
 const useReservationsInternal = createDataHook<
-	Reservation,
+	Reservation & { brandName: string; guestName: string; guestEmail: string; guestPhone: string },
 	UseReservationsOptions,
 	{ confirmedReservations: Reservation[]; activeReservations: Reservation[] }
 >({
 	model: "Reservation",
 	dataPropertyName: "reservations",
 	buildFilter,
+	// Include related data for brand name and guest info
+	selectionSet: [
+		"id",
+		"brandId",
+		"visitId",
+		"checkIn",
+		"checkOut",
+		"room",
+		"roomType",
+		"status",
+		"source",
+		"channel",
+		"confirmationCode",
+		"totalAmount",
+		"currency",
+		"nights",
+		"deletedAt",
+		"deletedBy",
+		"brand.name",
+		"visit.snapshot",
+	],
+	transform: transformReservation,
 	computedProperties: {
 		confirmedReservations: (reservations) =>
 			reservations.filter((r) => r.status === "confirmed"),
@@ -135,9 +190,9 @@ const useReservationsInternal = createDataHook<
 export function useReservations(options: UseReservationsOptions = {}): UseReservationsReturn {
 	const result = useReservationsInternal(options);
 	return {
-		reservations: result.reservations as Ref<Reservation[]>,
-		confirmedReservations: result.confirmedReservations as ComputedRef<Reservation[]>,
-		activeReservations: result.activeReservations as ComputedRef<Reservation[]>,
+		reservations: result.reservations as Ref<ReservationWithRelations[]>,
+		confirmedReservations: result.confirmedReservations as ComputedRef<ReservationWithRelations[]>,
+		activeReservations: result.activeReservations as ComputedRef<ReservationWithRelations[]>,
 		loading: result.loading,
 		error: result.error,
 		refetch: result.refetch,

package/src/hooks/users/index.ts

@@ -0,0 +1,2 @@
+export * from "./useUsers";
+export * from "./usePaginatedUsers";