@htlkg/data 0.0.20 → 0.0.21

package/src/queries/contacts.ts

@@ -0,0 +1,237 @@
+/**
+ * Contact Query Functions
+ *
+ * Provides query functions for fetching contact data from the GraphQL API.
+ */
+
+import type { Contact } from "@htlkg/core/types";
+
+/**
+ * Get a single contact by ID
+ *
+ * @example
+ * ```typescript
+ * import { getContact } from '@htlkg/data/queries';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const contact = await getContact(client, 'contact-123');
+ * ```
+ */
+export async function getContact<TClient = any>(
+	client: TClient,
+	id: string,
+): Promise<Contact | null> {
+	try {
+		const { data, errors } = await (client as any).models.Contact.get({ id });
+
+		if (errors) {
+			console.error("[getContact] GraphQL errors:", errors);
+			return null;
+		}
+
+		return data as Contact;
+	} catch (error) {
+		console.error("[getContact] Error fetching contact:", error);
+		throw error;
+	}
+}
+
+/**
+ * List all contacts with optional filtering
+ *
+ * @example
+ * ```typescript
+ * import { listContacts } from '@htlkg/data/queries';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const contacts = await listContacts(client, {
+ *   filter: { gdprConsent: { eq: true } },
+ *   limit: 50
+ * });
+ * ```
+ */
+export async function listContacts<TClient = any>(
+	client: TClient,
+	options?: {
+		filter?: any;
+		limit?: number;
+		nextToken?: string;
+	},
+): Promise<{ items: Contact[]; nextToken?: string }> {
+	try {
+		const { data, errors, nextToken } = await (
+			client as any
+		).models.Contact.list(options);
+
+		if (errors) {
+			console.error("[listContacts] GraphQL errors:", errors);
+			return { items: [], nextToken: undefined };
+		}
+
+		return {
+			items: (data || []) as Contact[],
+			nextToken,
+		};
+	} catch (error) {
+		console.error("[listContacts] Error fetching contacts:", error);
+		throw error;
+	}
+}
+
+/**
+ * List contacts by brand ID
+ *
+ * @example
+ * ```typescript
+ * import { listContactsByBrand } from '@htlkg/data/queries';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const contacts = await listContactsByBrand(client, 'brand-123');
+ * ```
+ */
+export async function listContactsByBrand<TClient = any>(
+	client: TClient,
+	brandId: string,
+	options?: {
+		limit?: number;
+		nextToken?: string;
+	},
+): Promise<{ items: Contact[]; nextToken?: string }> {
+	return listContacts(client, {
+		filter: { brandId: { eq: brandId } },
+		...options,
+	});
+}
+
+/**
+ * Get a contact by email within a brand
+ *
+ * @example
+ * ```typescript
+ * import { getContactByEmail } from '@htlkg/data/queries';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const contact = await getContactByEmail(client, 'guest@example.com', 'brand-123');
+ * ```
+ */
+export async function getContactByEmail<TClient = any>(
+	client: TClient,
+	email: string,
+	brandId: string,
+): Promise<Contact | null> {
+	try {
+		const { data, errors } = await (client as any).models.Contact.list({
+			filter: {
+				and: [{ email: { eq: email } }, { brandId: { eq: brandId } }],
+			},
+			limit: 1,
+		});
+
+		if (errors) {
+			console.error("[getContactByEmail] GraphQL errors:", errors);
+			return null;
+		}
+
+		return data?.[0] as Contact | null;
+	} catch (error) {
+		console.error("[getContactByEmail] Error fetching contact:", error);
+		throw error;
+	}
+}
+
+/**
+ * Get a contact by phone within a brand
+ *
+ * @example
+ * ```typescript
+ * import { getContactByPhone } from '@htlkg/data/queries';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const contact = await getContactByPhone(client, '+1234567890', 'brand-123');
+ * ```
+ */
+export async function getContactByPhone<TClient = any>(
+	client: TClient,
+	phone: string,
+	brandId: string,
+): Promise<Contact | null> {
+	try {
+		const { data, errors } = await (client as any).models.Contact.list({
+			filter: {
+				and: [{ phone: { eq: phone } }, { brandId: { eq: brandId } }],
+			},
+			limit: 1,
+		});
+
+		if (errors) {
+			console.error("[getContactByPhone] GraphQL errors:", errors);
+			return null;
+		}
+
+		return data?.[0] as Contact | null;
+	} catch (error) {
+		console.error("[getContactByPhone] Error fetching contact:", error);
+		throw error;
+	}
+}
+
+/**
+ * Search contacts by query string within a brand
+ * Searches across email, firstName, and lastName fields
+ *
+ * @example
+ * ```typescript
+ * import { searchContacts } from '@htlkg/data/queries';
+ * import { generateClient } from '@htlkg/data/client';
+ *
+ * const client = generateClient<Schema>();
+ * const contacts = await searchContacts(client, 'john', 'brand-123');
+ * ```
+ */
+export async function searchContacts<TClient = any>(
+	client: TClient,
+	query: string,
+	brandId: string,
+	options?: {
+		limit?: number;
+		nextToken?: string;
+	},
+): Promise<{ items: Contact[]; nextToken?: string }> {
+	try {
+		const { data, errors, nextToken } = await (
+			client as any
+		).models.Contact.list({
+			filter: {
+				and: [
+					{ brandId: { eq: brandId } },
+					{
+						or: [
+							{ email: { contains: query } },
+							{ firstName: { contains: query } },
+							{ lastName: { contains: query } },
+						],
+					},
+				],
+			},
+			...options,
+		});
+
+		if (errors) {
+			console.error("[searchContacts] GraphQL errors:", errors);
+			return { items: [], nextToken: undefined };
+		}
+
+		return {
+			items: (data || []) as Contact[],
+			nextToken,
+		};
+	} catch (error) {
+		console.error("[searchContacts] Error searching contacts:", error);
+		throw error;
+	}
+}

package/src/queries/index.ts

@@ -63,3 +63,13 @@ export {
 	getReservationByConfirmation,
 } from "./reservations";
 export type { Reservation } from "./reservations";
+
+// Contact queries
+export {
+	getContact,
+	listContacts,
+	listContactsByBrand,
+	getContactByEmail,
+	getContactByPhone,
+	searchContacts,
+} from "./contacts";