@htlkg/data 0.0.22 → 0.0.24

package/dist/hooks/index.d.ts

@@ -1038,4 +1038,103 @@ interface UseContactsReturn {
  */
 declare function useContacts(options?: UseContactsOptions): UseContactsReturn;
 
-export { ACTIVE_FILTER, type AccountWithBrands, type BaseHookOptions, type BrandWithCounts, type CreateDataHookOptions, type CreatePaginatedDataHookOptions, DELETED_FILTER, type DataHookReturn, type InferHookReturn, type InferPaginatedHookReturn, type AccountWithBrands as PaginatedAccountWithBrands, type PaginatedDataHookReturn, type PaginatedHookOptions, type PaginationState, type ReservationWithRelations, type UseAccountsOptions, type UseAccountsReturn, type UseBrandsOptions, type UseBrandsReturn, type UseContactsOptions, type UseContactsReturn, type UsePaginatedAccountsOptions, type UsePaginatedAccountsReturn, type UsePaginatedBrandsOptions, type UsePaginatedBrandsReturn, type UsePaginatedReservationsOptions, type UsePaginatedReservationsReturn, type UsePaginatedUsersOptions, type UsePaginatedUsersReturn, type UseProductInstancesOptions, type UseProductInstancesReturn, type UseProductsOptions, type UseProductsReturn, type UseReservationsOptions, type UseReservationsReturn, type UseUsersOptions, type UseUsersReturn, type UserWithRelations, createDataHook, createPaginatedDataHook, resetClientInstance, useAccounts, useActiveAccounts, useActiveBrands, useActiveReservations, useActiveUsers, useBrands, useContacts, useDeletedAccounts, useDeletedBrands, useDeletedReservations, useDeletedUsers, useProductInstances, useProducts, useReservations, useUsers };
+/**
+ * Paginated Contacts Hooks
+ *
+ * Vue composables for fetching contacts with server-side pagination.
+ * Provides separate hooks for active and deleted contacts to enable
+ * efficient tab-based filtering in large datasets.
+ */
+
+/** Extended Contact type with computed fields */
+type ContactWithRelations = Contact & {
+    brandName?: string;
+    name?: string;
+    deletedAt?: string;
+    deletedBy?: string;
+};
+interface UsePaginatedContactsOptions extends PaginatedHookOptions {
+    /** Filter by brand ID */
+    brandId?: string;
+    /** Search query (searches email, firstName, lastName) */
+    search?: string;
+    /** Filter by GDPR consent */
+    gdprConsent?: boolean;
+    /** Filter by marketing opt-in */
+    marketingOptIn?: boolean;
+    /** Filter by tags (contact must have at least one of these tags) */
+    tags?: string[];
+}
+interface UsePaginatedContactsReturn {
+    /** Reactive array of contacts */
+    contacts: Ref<ContactWithRelations[]>;
+    /** 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>;
+}
+/**
+ * Composable for fetching active (non-deleted) contacts with pagination
+ *
+ * @example
+ * ```typescript
+ * import { useActiveContacts } from '@htlkg/data/hooks';
+ *
+ * const { contacts, loading, hasMore, loadMore, refetch, setSearchFilter } = useActiveContacts({
+ *   pageSize: 25,
+ * });
+ *
+ * // Load more when user scrolls or clicks "Load More"
+ * async function onLoadMore() {
+ *   await loadMore();
+ * }
+ *
+ * // Server-side search (searches ALL contacts in database)
+ * async function onSearch(filter: any) {
+ *   await setSearchFilter(filter);
+ * }
+ * ```
+ *
+ * @example With filters
+ * ```typescript
+ * const { contacts, loading } = useActiveContacts({
+ *   brandId: 'brand-123',
+ *   gdprConsent: true,
+ *   pageSize: 50
+ * });
+ * ```
+ */
+declare function useActiveContacts(options?: UsePaginatedContactsOptions): UsePaginatedContactsReturn;
+/**
+ * Composable for fetching deleted contacts with pagination
+ *
+ * @example
+ * ```typescript
+ * import { useDeletedContacts } from '@htlkg/data/hooks';
+ *
+ * const { contacts, loading, hasMore, loadMore, refetch } = useDeletedContacts({
+ *   pageSize: 25,
+ * });
+ * ```
+ */
+declare function useDeletedContacts(options?: UsePaginatedContactsOptions): UsePaginatedContactsReturn;
+
+export { ACTIVE_FILTER, type AccountWithBrands, type BaseHookOptions, type BrandWithCounts, type ContactWithRelations, type CreateDataHookOptions, type CreatePaginatedDataHookOptions, DELETED_FILTER, type DataHookReturn, type InferHookReturn, type InferPaginatedHookReturn, type AccountWithBrands as PaginatedAccountWithBrands, type PaginatedDataHookReturn, type PaginatedHookOptions, type PaginationState, type ReservationWithRelations, type UseAccountsOptions, type UseAccountsReturn, type UseBrandsOptions, type UseBrandsReturn, type UseContactsOptions, type UseContactsReturn, type UsePaginatedAccountsOptions, type UsePaginatedAccountsReturn, type UsePaginatedBrandsOptions, type UsePaginatedBrandsReturn, type UsePaginatedContactsOptions, type UsePaginatedContactsReturn, type UsePaginatedReservationsOptions, type UsePaginatedReservationsReturn, type UsePaginatedUsersOptions, type UsePaginatedUsersReturn, type UseProductInstancesOptions, type UseProductInstancesReturn, type UseProductsOptions, type UseProductsReturn, type UseReservationsOptions, type UseReservationsReturn, type UseUsersOptions, type UseUsersReturn, type UserWithRelations, createDataHook, createPaginatedDataHook, resetClientInstance, useAccounts, useActiveAccounts, useActiveBrands, useActiveContacts, useActiveReservations, useActiveUsers, useBrands, useContacts, useDeletedAccounts, useDeletedBrands, useDeletedContacts, useDeletedReservations, useDeletedUsers, useProductInstances, useProducts, useReservations, useUsers };

package/dist/hooks/index.js

@@ -55,7 +55,7 @@ function createDataHook(config) {
     defaultLimit,
     selectionSet,
     transform,
-    buildFilter: buildFilter10,
+    buildFilter: buildFilter11,
     computedProperties,
     dataPropertyName = "data"
   } = config;
@@ -65,8 +65,8 @@ function createDataHook(config) {
     const loading = ref(false);
     const error = ref(null);
     const getFilter = () => {
-      if (buildFilter10) {
-        return buildFilter10(options);
+      if (buildFilter11) {
+        return buildFilter11(options);
       }
       return baseFilter && Object.keys(baseFilter).length > 0 ? baseFilter : void 0;
     };
@@ -140,7 +140,7 @@ function createPaginatedDataHook(config) {
     defaultPageSize = 25,
     selectionSet,
     transform,
-    buildFilter: buildFilter10,
+    buildFilter: buildFilter11,
     dataPropertyName = "data",
     baseFilter
   } = config;
@@ -163,8 +163,8 @@ function createPaginatedDataHook(config) {
       if (baseFilter) {
         filters.push(baseFilter);
       }
-      if (buildFilter10) {
-        const customFilter = buildFilter10(options);
+      if (buildFilter11) {
+        const customFilter = buildFilter11(options);
         if (customFilter) {
           filters.push(customFilter);
         }
@@ -1113,7 +1113,7 @@ function useProductInstances(options = {}) {
   };
 }
 
-// src/hooks/useContacts.ts
+// src/hooks/contacts/useContacts.ts
 function buildFilter9(options) {
   const conditions = [];
   if (options.brandId) {
@@ -1171,6 +1171,128 @@ function useContacts(options = {}) {
     refetch: result.refetch
   };
 }
+
+// src/hooks/contacts/usePaginatedContacts.ts
+function buildFilter10(options) {
+  const conditions = [];
+  if (options.brandId) {
+    conditions.push({ brandId: { eq: options.brandId } });
+  }
+  if (options.search) {
+    conditions.push({
+      or: [
+        { email: { contains: options.search } },
+        { firstName: { contains: options.search } },
+        { lastName: { contains: options.search } }
+      ]
+    });
+  }
+  if (options.gdprConsent !== void 0) {
+    conditions.push({ gdprConsent: { eq: options.gdprConsent } });
+  }
+  if (options.marketingOptIn !== void 0) {
+    conditions.push({ marketingOptIn: { eq: options.marketingOptIn } });
+  }
+  if (options.tags && options.tags.length > 0) {
+    const tagConditions = options.tags.map((tag) => ({
+      tags: { contains: tag }
+    }));
+    conditions.push({ or: tagConditions });
+  }
+  if (options.filter && Object.keys(options.filter).length > 0) {
+    conditions.push(options.filter);
+  }
+  if (conditions.length === 0) {
+    return void 0;
+  }
+  if (conditions.length === 1) {
+    return conditions[0];
+  }
+  return { and: conditions };
+}
+function transformContact(contact) {
+  return {
+    ...contact,
+    name: `${contact.firstName || ""} ${contact.lastName || ""}`.trim() || contact.email,
+    brandName: contact.brand?.name || ""
+  };
+}
+var CONTACT_SELECTION_SET = [
+  "id",
+  "email",
+  "phone",
+  "firstName",
+  "lastName",
+  "locale",
+  "brandId",
+  "gdprConsent",
+  "gdprConsentDate",
+  "marketingOptIn",
+  "preferences",
+  "tags",
+  "totalVisits",
+  "lastVisitDate",
+  "firstVisitDate",
+  "source",
+  "status",
+  "createdAt",
+  "updatedAt",
+  "deletedAt",
+  "deletedBy",
+  "brand.name"
+];
+var useActiveContactsInternal = createPaginatedDataHook({
+  model: "Contact",
+  dataPropertyName: "contacts",
+  defaultPageSize: 25,
+  selectionSet: CONTACT_SELECTION_SET,
+  transform: transformContact,
+  buildFilter: buildFilter10,
+  baseFilter: ACTIVE_FILTER
+});
+var useDeletedContactsInternal = createPaginatedDataHook({
+  model: "Contact",
+  dataPropertyName: "contacts",
+  defaultPageSize: 25,
+  selectionSet: CONTACT_SELECTION_SET,
+  transform: transformContact,
+  buildFilter: buildFilter10,
+  baseFilter: DELETED_FILTER
+});
+function useActiveContacts(options = {}) {
+  const result = useActiveContactsInternal(options);
+  return {
+    contacts: result.contacts,
+    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
+  };
+}
+function useDeletedContacts(options = {}) {
+  const result = useDeletedContactsInternal(options);
+  return {
+    contacts: result.contacts,
+    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
+  };
+}
 export {
   ACTIVE_FILTER,
   DELETED_FILTER,
@@ -1180,12 +1302,14 @@ export {
   useAccounts,
   useActiveAccounts,
   useActiveBrands,
+  useActiveContacts,
   useActiveReservations,
   useActiveUsers,
   useBrands,
   useContacts,
   useDeletedAccounts,
   useDeletedBrands,
+  useDeletedContacts,
   useDeletedReservations,
   useDeletedUsers,
   useProductInstances,