@htlkg/data 0.0.19 → 0.0.21

package/src/queries/reservations.ts

@@ -0,0 +1,247 @@
+/**
+ * Reservation Query Functions
+ *
+ * Provides query functions for fetching reservation data from the GraphQL API.
+ */
+
+/**
+ * Reservation type for query results
+ */
+export interface Reservation {
+	id: string;
+	brandId: string;
+	visitId: string;
+	confirmationCode: string;
+	checkIn: string;
+	checkOut: string;
+	status: "confirmed" | "checked_in" | "checked_out" | "cancelled" | "no_show";
+	source?: string;
+	channel?: string;
+	roomType?: string;
+	room?: string;
+	totalAmount?: number;
+	currency?: string;
+	nights?: number;
+	createdAt?: string;
+	createdBy?: string;
+	updatedAt?: string;
+	updatedBy?: string;
+	deletedAt?: string | null;
+	deletedBy?: string | null;
+}
+
+/**
+ * Get a single reservation by ID
+ *
+ * @example
+ * ```typescript
+ * import { getReservation } from '@htlkg/data/queries';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const reservation = await getReservation(client, 'reservation-123');
+ * ```
+ */
+export async function getReservation<TClient = any>(
+	client: TClient,
+	id: string,
+): Promise<Reservation | null> {
+	try {
+		const { data, errors } = await (client as any).models.Reservation.get({ id });
+
+		if (errors) {
+			console.error("[getReservation] GraphQL errors:", errors);
+			return null;
+		}
+
+		return data as Reservation;
+	} catch (error) {
+		console.error("[getReservation] Error fetching reservation:", error);
+		throw error;
+	}
+}
+
+/**
+ * List all reservations with optional filtering and pagination
+ *
+ * @example
+ * ```typescript
+ * import { listReservations } from '@htlkg/data/queries';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const reservations = await listReservations(client, {
+ *   filter: { status: { eq: 'confirmed' } },
+ *   limit: 50
+ * });
+ * ```
+ */
+export async function listReservations<TClient = any>(
+	client: TClient,
+	options?: {
+		filter?: any;
+		limit?: number;
+		nextToken?: string;
+	},
+): Promise<{ items: Reservation[]; nextToken?: string }> {
+	try {
+		const { data, errors, nextToken } = await (client as any).models.Reservation.list(
+			options,
+		);
+
+		if (errors) {
+			console.error("[listReservations] GraphQL errors:", errors);
+			return { items: [], nextToken: undefined };
+		}
+
+		return {
+			items: (data || []) as Reservation[],
+			nextToken,
+		};
+	} catch (error) {
+		console.error("[listReservations] Error fetching reservations:", error);
+		throw error;
+	}
+}
+
+/**
+ * List reservations by brand ID
+ *
+ * @example
+ * ```typescript
+ * import { listReservationsByBrand } from '@htlkg/data/queries';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const reservations = await listReservationsByBrand(client, 'brand-123', {
+ *   limit: 100
+ * });
+ * ```
+ */
+export async function listReservationsByBrand<TClient = any>(
+	client: TClient,
+	brandId: string,
+	options?: {
+		filter?: any;
+		limit?: number;
+		nextToken?: string;
+	},
+): Promise<{ items: Reservation[]; nextToken?: string }> {
+	const filter = options?.filter
+		? { and: [{ brandId: { eq: brandId } }, options.filter] }
+		: { brandId: { eq: brandId } };
+
+	return listReservations(client, {
+		filter,
+		limit: options?.limit,
+		nextToken: options?.nextToken,
+	});
+}
+
+/**
+ * List reservations by contact/visit ID
+ *
+ * @example
+ * ```typescript
+ * import { listReservationsByContact } from '@htlkg/data/queries';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const reservations = await listReservationsByContact(client, 'contact-123');
+ * ```
+ */
+export async function listReservationsByContact<TClient = any>(
+	client: TClient,
+	contactId: string,
+	options?: {
+		limit?: number;
+		nextToken?: string;
+	},
+): Promise<{ items: Reservation[]; nextToken?: string }> {
+	return listReservations(client, {
+		filter: { visitId: { eq: contactId } },
+		...options,
+	});
+}
+
+/**
+ * List reservations by date range for a specific brand
+ *
+ * Filters reservations where check-in date falls within the specified range.
+ *
+ * @example
+ * ```typescript
+ * import { listReservationsByDateRange } from '@htlkg/data/queries';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const reservations = await listReservationsByDateRange(
+ *   client,
+ *   'brand-123',
+ *   '2024-01-01',
+ *   '2024-01-31'
+ * );
+ * ```
+ */
+export async function listReservationsByDateRange<TClient = any>(
+	client: TClient,
+	brandId: string,
+	startDate: string,
+	endDate: string,
+	options?: {
+		limit?: number;
+		nextToken?: string;
+	},
+): Promise<{ items: Reservation[]; nextToken?: string }> {
+	return listReservations(client, {
+		filter: {
+			and: [
+				{ brandId: { eq: brandId } },
+				{ checkIn: { ge: startDate } },
+				{ checkIn: { le: endDate } },
+			],
+		},
+		...options,
+	});
+}
+
+/**
+ * Get a reservation by confirmation code and brand ID
+ *
+ * Returns the first matching reservation or null if not found.
+ *
+ * @example
+ * ```typescript
+ * import { getReservationByConfirmation } from '@htlkg/data/queries';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const reservation = await getReservationByConfirmation(
+ *   client,
+ *   'ABC123',
+ *   'brand-123'
+ * );
+ * ```
+ */
+export async function getReservationByConfirmation<TClient = any>(
+	client: TClient,
+	confirmationCode: string,
+	brandId: string,
+): Promise<Reservation | null> {
+	try {
+		const { items } = await listReservations(client, {
+			filter: {
+				and: [
+					{ confirmationCode: { eq: confirmationCode } },
+					{ brandId: { eq: brandId } },
+				],
+			},
+			limit: 1,
+		});
+
+		return items.length > 0 ? items[0] : null;
+	} catch (error) {
+		console.error("[getReservationByConfirmation] Error fetching reservation:", error);
+		throw error;
+	}
+}