@elqnt/entity 2.1.3 → 2.2.0

package/dist/chunk-F7ZN7FHI.mjs

@@ -0,0 +1,427 @@
+"use client";
+import {
+  bulkCreateEntityRecordsApi,
+  bulkDeleteEntityRecordsApi,
+  bulkUpdateEntityRecordsApi,
+  countEntityRecordsApi,
+  createEntityDefinitionApi,
+  createEntityRecordApi,
+  deleteEntityDefinitionApi,
+  deleteEntityRecordApi,
+  getEntityDefinitionApi,
+  getEntityRecordApi,
+  listEntityDefinitionsApi,
+  queryEntityRecordsApi,
+  updateEntityDefinitionApi,
+  updateEntityRecordApi
+} from "./chunk-SHMUKUYC.mjs";
+
+// hooks/use-entity-definitions.ts
+import { useMemo } from "react";
+
+// hooks/use-async.ts
+import { useState, useCallback } from "react";
+function useAsync(asyncFn, transform, defaultValue, options = {}) {
+  const { resetErrorOnRequest = true } = options;
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const execute = useCallback(
+    async (...args) => {
+      setLoading(true);
+      if (resetErrorOnRequest) {
+        setError(null);
+      }
+      try {
+        const response = await asyncFn(...args);
+        if (response.error) {
+          setError(response.error);
+          return defaultValue;
+        }
+        if (!response.data) {
+          return defaultValue;
+        }
+        return transform(response.data);
+      } catch (err) {
+        const message = err instanceof Error ? err.message : "An error occurred";
+        setError(message);
+        return defaultValue;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [asyncFn, transform, defaultValue, resetErrorOnRequest]
+  );
+  return { execute, loading, error };
+}
+function useApiAsync(asyncFn, transform, defaultValue) {
+  return useAsync(asyncFn, transform, defaultValue);
+}
+
+// hooks/use-options-ref.ts
+import { useRef, useEffect } from "react";
+function useOptionsRef(options) {
+  const optionsRef = useRef(options);
+  useEffect(() => {
+    optionsRef.current = options;
+  }, [options]);
+  return optionsRef;
+}
+
+// hooks/use-entity-definitions.ts
+function useEntityDefinitions(options) {
+  const optionsRef = useOptionsRef(options);
+  const { execute: listDefinitions, loading: listLoading, error: listError } = useApiAsync(
+    () => listEntityDefinitionsApi(optionsRef.current),
+    (data) => data.definitions || [],
+    []
+  );
+  const { execute: getDefinition, loading: getLoading, error: getError } = useApiAsync(
+    (entityName) => getEntityDefinitionApi(entityName, optionsRef.current),
+    (data) => data.definition || null,
+    null
+  );
+  const { execute: createDefinition, loading: createLoading, error: createError } = useApiAsync(
+    (definition) => createEntityDefinitionApi(definition, optionsRef.current),
+    (data) => data.definition || null,
+    null
+  );
+  const { execute: updateDefinition, loading: updateLoading, error: updateError } = useApiAsync(
+    (entityName, definition) => updateEntityDefinitionApi(entityName, definition, optionsRef.current),
+    (data) => data.definition || null,
+    null
+  );
+  const { execute: deleteDefinition, loading: deleteLoading, error: deleteError } = useApiAsync(
+    (entityName) => deleteEntityDefinitionApi(entityName, optionsRef.current),
+    (data) => data.success,
+    false
+  );
+  const loading = listLoading || getLoading || createLoading || updateLoading || deleteLoading;
+  const error = listError || getError || createError || updateError || deleteError;
+  return useMemo(
+    () => ({
+      loading,
+      error,
+      listDefinitions,
+      getDefinition,
+      createDefinition,
+      updateDefinition,
+      deleteDefinition
+    }),
+    [loading, error, listDefinitions, getDefinition, createDefinition, updateDefinition, deleteDefinition]
+  );
+}
+
+// hooks/use-entity-records.ts
+import { useMemo as useMemo2 } from "react";
+function useEntityRecords(options) {
+  const optionsRef = useOptionsRef(options);
+  const getEntityName = () => optionsRef.current.entityName;
+  const getApiOptions = () => {
+    const { entityName: _, ...apiOptions } = optionsRef.current;
+    return apiOptions;
+  };
+  const { execute: queryRecords, loading: queryLoading, error: queryError } = useApiAsync(
+    (params) => {
+      const queryParams = {
+        page: params?.page || 1,
+        pageSize: params?.pageSize || 20
+      };
+      if (params?.filters) {
+        queryParams.filters = JSON.stringify(params.filters);
+      }
+      if (params?.sortBy) {
+        queryParams.sortBy = params.sortBy;
+      }
+      if (params?.sortOrder) {
+        queryParams.sortOrder = params.sortOrder;
+      }
+      return queryEntityRecordsApi(getEntityName(), queryParams, getApiOptions());
+    },
+    (data) => {
+      if (data?.records?.items) {
+        return {
+          records: data.records.items,
+          total: data.records.totalCount,
+          page: data.records.currentPage,
+          pageSize: data.records.pageSize
+        };
+      }
+      return {
+        records: data?.records || [],
+        total: data?.total || 0,
+        page: data?.page || 1,
+        pageSize: data?.pageSize || 20
+      };
+    },
+    { records: [], total: 0, page: 1, pageSize: 20 }
+  );
+  const { execute: getRecord, loading: getLoading, error: getError } = useApiAsync(
+    (recordId) => getEntityRecordApi(getEntityName(), recordId, getApiOptions()),
+    (data) => data.record || null,
+    null
+  );
+  const { execute: createRecord, loading: createLoading, error: createError } = useApiAsync(
+    (record) => createEntityRecordApi(getEntityName(), record, getApiOptions()),
+    (data) => data.record || null,
+    null
+  );
+  const { execute: updateRecord, loading: updateLoading, error: updateError } = useApiAsync(
+    (recordId, record) => updateEntityRecordApi(getEntityName(), recordId, record, getApiOptions()),
+    (data) => data.record || null,
+    null
+  );
+  const { execute: deleteRecord, loading: deleteLoading, error: deleteError } = useApiAsync(
+    (recordId) => deleteEntityRecordApi(getEntityName(), recordId, getApiOptions()),
+    (data) => data.success,
+    false
+  );
+  const { execute: countRecords, loading: countLoading, error: countError } = useApiAsync(
+    (filters) => countEntityRecordsApi(getEntityName(), filters || {}, getApiOptions()),
+    (data) => data.count,
+    0
+  );
+  const { execute: bulkCreate, loading: bulkCreateLoading, error: bulkCreateError } = useApiAsync(
+    (records) => bulkCreateEntityRecordsApi(getEntityName(), records, getApiOptions()),
+    (data) => ({ records: data.records, success: true }),
+    { success: false }
+  );
+  const { execute: bulkUpdate, loading: bulkUpdateLoading, error: bulkUpdateError } = useApiAsync(
+    (records) => bulkUpdateEntityRecordsApi(getEntityName(), records, getApiOptions()),
+    (data) => ({ records: data.records, success: true }),
+    { success: false }
+  );
+  const { execute: bulkDelete, loading: bulkDeleteLoading, error: bulkDeleteError } = useApiAsync(
+    (recordIds) => bulkDeleteEntityRecordsApi(getEntityName(), recordIds, getApiOptions()),
+    (data) => data.success,
+    false
+  );
+  const loading = queryLoading || getLoading || createLoading || updateLoading || deleteLoading || countLoading || bulkCreateLoading || bulkUpdateLoading || bulkDeleteLoading;
+  const error = queryError || getError || createError || updateError || deleteError || countError || bulkCreateError || bulkUpdateError || bulkDeleteError;
+  return useMemo2(
+    () => ({
+      loading,
+      error,
+      queryRecords,
+      getRecord,
+      createRecord,
+      updateRecord,
+      deleteRecord,
+      countRecords,
+      bulkCreate,
+      bulkUpdate,
+      bulkDelete
+    }),
+    [
+      loading,
+      error,
+      queryRecords,
+      getRecord,
+      createRecord,
+      updateRecord,
+      deleteRecord,
+      countRecords,
+      bulkCreate,
+      bulkUpdate,
+      bulkDelete
+    ]
+  );
+}
+
+// hooks/use-entities.ts
+import { useState as useState2, useCallback as useCallback2 } from "react";
+function useEntities(options) {
+  const [loading, setLoading] = useState2(false);
+  const [error, setError] = useState2(null);
+  const listDefinitions = useCallback2(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const response = await listEntityDefinitionsApi(options);
+      if (response.error) {
+        setError(response.error);
+        return [];
+      }
+      return response.data?.definitions || [];
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Failed to load definitions";
+      setError(message);
+      return [];
+    } finally {
+      setLoading(false);
+    }
+  }, [options]);
+  const getDefinition = useCallback2(
+    async (entityName) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const response = await getEntityDefinitionApi(entityName, options);
+        if (response.error) {
+          setError(response.error);
+          return null;
+        }
+        return response.data?.definition || null;
+      } catch (err) {
+        const message = err instanceof Error ? err.message : "Failed to get definition";
+        setError(message);
+        return null;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [options]
+  );
+  const queryRecords = useCallback2(
+    async (entityName, query = {}) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const queryParams = {
+          page: query.page || 1,
+          pageSize: query.pageSize || 20
+        };
+        if (query.filters) {
+          queryParams.filters = JSON.stringify(query.filters);
+        }
+        if (query.sortBy) {
+          queryParams.sortBy = query.sortBy;
+        }
+        if (query.sortOrder) {
+          queryParams.sortOrder = query.sortOrder;
+        }
+        const response = await queryEntityRecordsApi(entityName, queryParams, options);
+        if (response.error) {
+          setError(response.error);
+          return { records: [], total: 0, page: 1, pageSize: 20 };
+        }
+        const data = response.data;
+        if (data?.records?.items) {
+          return {
+            records: data.records.items,
+            total: data.records.totalCount,
+            page: data.records.currentPage,
+            pageSize: data.records.pageSize
+          };
+        }
+        return {
+          records: data?.records || [],
+          total: data?.total || 0,
+          page: data?.page || 1,
+          pageSize: data?.pageSize || 20
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : "Failed to query records";
+        setError(message);
+        return { records: [], total: 0, page: 1, pageSize: 20 };
+      } finally {
+        setLoading(false);
+      }
+    },
+    [options]
+  );
+  const getRecord = useCallback2(
+    async (entityName, recordId) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const response = await getEntityRecordApi(entityName, recordId, options);
+        if (response.error) {
+          setError(response.error);
+          return null;
+        }
+        return response.data?.record || null;
+      } catch (err) {
+        const message = err instanceof Error ? err.message : "Failed to get record";
+        setError(message);
+        return null;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [options]
+  );
+  const createRecord = useCallback2(
+    async (entityName, record) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const response = await createEntityRecordApi(entityName, record, options);
+        if (response.error) {
+          setError(response.error);
+          return null;
+        }
+        return response.data?.record || null;
+      } catch (err) {
+        const message = err instanceof Error ? err.message : "Failed to create record";
+        setError(message);
+        return null;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [options]
+  );
+  const updateRecord = useCallback2(
+    async (entityName, recordId, record) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const response = await updateEntityRecordApi(entityName, recordId, record, options);
+        if (response.error) {
+          setError(response.error);
+          return null;
+        }
+        return response.data?.record || null;
+      } catch (err) {
+        const message = err instanceof Error ? err.message : "Failed to update record";
+        setError(message);
+        return null;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [options]
+  );
+  const deleteRecord = useCallback2(
+    async (entityName, recordId) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const response = await deleteEntityRecordApi(entityName, recordId, options);
+        if (response.error) {
+          setError(response.error);
+          return false;
+        }
+        return true;
+      } catch (err) {
+        const message = err instanceof Error ? err.message : "Failed to delete record";
+        setError(message);
+        return false;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [options]
+  );
+  return {
+    loading,
+    error,
+    listDefinitions,
+    getDefinition,
+    queryRecords,
+    getRecord,
+    createRecord,
+    updateRecord,
+    deleteRecord
+  };
+}
+
+export {
+  useAsync,
+  useApiAsync,
+  useOptionsRef,
+  useEntityDefinitions,
+  useEntityRecords,
+  useEntities
+};
+//# sourceMappingURL=chunk-F7ZN7FHI.mjs.map

package/dist/chunk-F7ZN7FHI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../hooks/use-entity-definitions.ts","../hooks/use-async.ts","../hooks/use-options-ref.ts","../hooks/use-entity-records.ts","../hooks/use-entities.ts"],"sourcesContent":["\"use client\";\n\n/**\n * Entity definition hooks for React applications\n *\n * Provides React hooks for entity definition CRUD operations with loading/error states.\n */\n\nimport { useMemo } from \"react\";\nimport type { ApiClientOptions } from \"@elqnt/api-client\";\nimport type { EntityDefinition } from \"../models\";\nimport {\n  listEntityDefinitionsApi,\n  getEntityDefinitionApi,\n  createEntityDefinitionApi,\n  updateEntityDefinitionApi,\n  deleteEntityDefinitionApi,\n} from \"../api\";\nimport { useApiAsync } from \"./use-async\";\nimport { useOptionsRef } from \"./use-options-ref\";\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport type UseEntityDefinitionsOptions = ApiClientOptions;\n\n// =============================================================================\n// USE ENTITY DEFINITIONS HOOK\n// =============================================================================\n\n/**\n * Hook for entity definition CRUD operations\n *\n * @example\n * ```tsx\n * const { loading, error, listDefinitions, getDefinition, createDefinition } = useEntityDefinitions({\n *   baseUrl: apiGatewayUrl,\n *   orgId: selectedOrgId,\n * });\n *\n * const definitions = await listDefinitions();\n * const definition = await getDefinition(\"contacts\");\n * const newDef = await createDefinition({ name: \"leads\", title: \"Leads\" });\n * ```\n */\nexport function useEntityDefinitions(options: UseEntityDefinitionsOptions) {\n  const optionsRef = useOptionsRef(options);\n\n  const { execute: listDefinitions, loading: listLoading, error: listError } = useApiAsync(\n    () => listEntityDefinitionsApi(optionsRef.current),\n    (data) => data.definitions || [],\n    [] as EntityDefinition[]\n  );\n\n  const { execute: getDefinition, loading: getLoading, error: getError } = useApiAsync(\n    (entityName: string) => getEntityDefinitionApi(entityName, optionsRef.current),\n    (data) => data.definition || null,\n    null as EntityDefinition | null\n  );\n\n  const { execute: createDefinition, loading: createLoading, error: createError } = useApiAsync(\n    (definition: Partial<EntityDefinition>) =>\n      createEntityDefinitionApi(definition, optionsRef.current),\n    (data) => data.definition || null,\n    null as EntityDefinition | null\n  );\n\n  const { execute: updateDefinition, loading: updateLoading, error: updateError } = useApiAsync(\n    (entityName: string, definition: Partial<EntityDefinition>) =>\n      updateEntityDefinitionApi(entityName, definition, optionsRef.current),\n    (data) => data.definition || null,\n    null as EntityDefinition | null\n  );\n\n  const { execute: deleteDefinition, loading: deleteLoading, error: deleteError } = useApiAsync(\n    (entityName: string) => deleteEntityDefinitionApi(entityName, optionsRef.current),\n    (data) => data.success,\n    false\n  );\n\n  const loading = listLoading || getLoading || createLoading || updateLoading || deleteLoading;\n  const error = listError || getError || createError || updateError || deleteError;\n\n  return useMemo(\n    () => ({\n      loading,\n      error,\n      listDefinitions,\n      getDefinition,\n      createDefinition,\n      updateDefinition,\n      deleteDefinition,\n    }),\n    [loading, error, listDefinitions, getDefinition, createDefinition, updateDefinition, deleteDefinition]\n  );\n}\n","\"use client\";\n\n/**\n * Async operation hooks with loading/error state management\n */\n\nimport { useState, useCallback } from \"react\";\nimport type { ApiResponse } from \"@elqnt/api-client\";\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface UseAsyncOptions {\n  /** Reset error on new request */\n  resetErrorOnRequest?: boolean;\n}\n\nexport interface UseAsyncReturn<TArgs extends unknown[], TResult> {\n  execute: (...args: TArgs) => Promise<TResult>;\n  loading: boolean;\n  error: string | null;\n}\n\n// =============================================================================\n// USE ASYNC HOOK\n// =============================================================================\n\n/**\n * Generic async operation hook with loading/error states\n *\n * @example\n * ```tsx\n * const { execute: fetchUser, loading, error } = useAsync(\n *   (userId: string) => getUserApi(userId, options),\n *   (data) => data.user,\n *   null\n * );\n *\n * const user = await fetchUser(\"user-123\");\n * ```\n */\nexport function useAsync<TArgs extends unknown[], TData, TResult>(\n  asyncFn: (...args: TArgs) => Promise<ApiResponse<TData>>,\n  transform: (data: TData) => TResult,\n  defaultValue: TResult,\n  options: UseAsyncOptions = {}\n): UseAsyncReturn<TArgs, TResult> {\n  const { resetErrorOnRequest = true } = options;\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n\n  const execute = useCallback(\n    async (...args: TArgs): Promise<TResult> => {\n      setLoading(true);\n      if (resetErrorOnRequest) {\n        setError(null);\n      }\n\n      try {\n        const response = await asyncFn(...args);\n\n        if (response.error) {\n          setError(response.error);\n          return defaultValue;\n        }\n\n        if (!response.data) {\n          return defaultValue;\n        }\n\n        return transform(response.data);\n      } catch (err) {\n        const message = err instanceof Error ? err.message : \"An error occurred\";\n        setError(message);\n        return defaultValue;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [asyncFn, transform, defaultValue, resetErrorOnRequest]\n  );\n\n  return { execute, loading, error };\n}\n\n/**\n * Simplified async hook for API operations\n *\n * @example\n * ```tsx\n * const { execute: getUsers, loading, error } = useApiAsync(\n *   () => listUsersApi(optionsRef.current),\n *   (data) => data.users,\n *   []\n * );\n * ```\n */\nexport function useApiAsync<TArgs extends unknown[], TData, TResult>(\n  asyncFn: (...args: TArgs) => Promise<ApiResponse<TData>>,\n  transform: (data: TData) => TResult,\n  defaultValue: TResult\n): UseAsyncReturn<TArgs, TResult> {\n  return useAsync(asyncFn, transform, defaultValue);\n}\n","\"use client\";\n\n/**\n * Options ref hook for stable callback references\n *\n * Keeps options in a ref to avoid stale closures in callbacks\n * while maintaining referential stability.\n */\n\nimport { useRef, useEffect } from \"react\";\n\n/**\n * Hook that keeps options in a ref for stable callback access\n *\n * @example\n * ```tsx\n * const optionsRef = useOptionsRef({ baseUrl, orgId });\n *\n * const fetchData = useCallback(async () => {\n *   // Always accesses latest options without recreating callback\n *   await api.fetch(optionsRef.current);\n * }, []); // No dependencies needed\n * ```\n */\nexport function useOptionsRef<T>(options: T) {\n  const optionsRef = useRef(options);\n\n  useEffect(() => {\n    optionsRef.current = options;\n  }, [options]);\n\n  return optionsRef;\n}\n","\"use client\";\n\n/**\n * Entity record hooks for React applications\n *\n * Provides React hooks for entity record CRUD operations with loading/error states.\n */\n\nimport { useMemo } from \"react\";\nimport type { ApiClientOptions } from \"@elqnt/api-client\";\nimport type { EntityRecord } from \"../models\";\nimport {\n  queryEntityRecordsApi,\n  getEntityRecordApi,\n  createEntityRecordApi,\n  updateEntityRecordApi,\n  deleteEntityRecordApi,\n  countEntityRecordsApi,\n  bulkCreateEntityRecordsApi,\n  bulkUpdateEntityRecordsApi,\n  bulkDeleteEntityRecordsApi,\n} from \"../api\";\nimport { useApiAsync } from \"./use-async\";\nimport { useOptionsRef } from \"./use-options-ref\";\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface UseEntityRecordsOptions extends ApiClientOptions {\n  /** Entity name to operate on */\n  entityName: string;\n}\n\nexport interface QueryRecordsParams {\n  page?: number;\n  pageSize?: number;\n  filters?: Record<string, unknown>;\n  sortBy?: string;\n  sortOrder?: \"asc\" | \"desc\";\n}\n\nexport interface QueryRecordsResult {\n  records: EntityRecord[];\n  total: number;\n  page: number;\n  pageSize: number;\n}\n\nexport interface BulkOperationResult {\n  records?: EntityRecord[];\n  success: boolean;\n}\n\n// =============================================================================\n// USE ENTITY RECORDS HOOK\n// =============================================================================\n\n/**\n * Hook for entity record CRUD operations\n *\n * @example\n * ```tsx\n * const {\n *   loading, error,\n *   queryRecords, getRecord, createRecord, updateRecord, deleteRecord,\n *   countRecords, bulkCreate, bulkUpdate, bulkDelete\n * } = useEntityRecords({\n *   baseUrl: apiGatewayUrl,\n *   orgId: selectedOrgId,\n *   entityName: \"contacts\",\n * });\n *\n * const { records, total } = await queryRecords({ page: 1, pageSize: 20 });\n * const record = await getRecord(\"record-id\");\n * const count = await countRecords({ status: \"active\" });\n * ```\n */\nexport function useEntityRecords(options: UseEntityRecordsOptions) {\n  const optionsRef = useOptionsRef(options);\n\n  const getEntityName = () => optionsRef.current.entityName;\n  const getApiOptions = (): ApiClientOptions => {\n    const { entityName: _, ...apiOptions } = optionsRef.current;\n    return apiOptions;\n  };\n\n  const { execute: queryRecords, loading: queryLoading, error: queryError } = useApiAsync(\n    (params?: QueryRecordsParams) => {\n      const queryParams: Record<string, unknown> = {\n        page: params?.page || 1,\n        pageSize: params?.pageSize || 20,\n      };\n      if (params?.filters) {\n        queryParams.filters = JSON.stringify(params.filters);\n      }\n      if (params?.sortBy) {\n        queryParams.sortBy = params.sortBy;\n      }\n      if (params?.sortOrder) {\n        queryParams.sortOrder = params.sortOrder;\n      }\n      return queryEntityRecordsApi(getEntityName(), queryParams, getApiOptions());\n    },\n    (data): QueryRecordsResult => {\n      // Handle both direct records array and nested ListResult structure\n      if (data?.records?.items) {\n        return {\n          records: data.records.items,\n          total: data.records.totalCount,\n          page: data.records.currentPage,\n          pageSize: data.records.pageSize,\n        };\n      }\n      // Fallback for simpler response structure\n      return {\n        records: (data as any)?.records || [],\n        total: (data as any)?.total || 0,\n        page: (data as any)?.page || 1,\n        pageSize: (data as any)?.pageSize || 20,\n      };\n    },\n    { records: [], total: 0, page: 1, pageSize: 20 } as QueryRecordsResult\n  );\n\n  const { execute: getRecord, loading: getLoading, error: getError } = useApiAsync(\n    (recordId: string) => getEntityRecordApi(getEntityName(), recordId, getApiOptions()),\n    (data) => data.record || null,\n    null as EntityRecord | null\n  );\n\n  const { execute: createRecord, loading: createLoading, error: createError } = useApiAsync(\n    (record: Partial<EntityRecord>) => createEntityRecordApi(getEntityName(), record, getApiOptions()),\n    (data) => data.record || null,\n    null as EntityRecord | null\n  );\n\n  const { execute: updateRecord, loading: updateLoading, error: updateError } = useApiAsync(\n    (recordId: string, record: Partial<EntityRecord>) =>\n      updateEntityRecordApi(getEntityName(), recordId, record, getApiOptions()),\n    (data) => data.record || null,\n    null as EntityRecord | null\n  );\n\n  const { execute: deleteRecord, loading: deleteLoading, error: deleteError } = useApiAsync(\n    (recordId: string) => deleteEntityRecordApi(getEntityName(), recordId, getApiOptions()),\n    (data) => data.success,\n    false\n  );\n\n  const { execute: countRecords, loading: countLoading, error: countError } = useApiAsync(\n    (filters?: Record<string, unknown>) =>\n      countEntityRecordsApi(getEntityName(), filters || {}, getApiOptions()),\n    (data) => data.count,\n    0\n  );\n\n  const { execute: bulkCreate, loading: bulkCreateLoading, error: bulkCreateError } = useApiAsync(\n    (records: Partial<EntityRecord>[]) =>\n      bulkCreateEntityRecordsApi(getEntityName(), records, getApiOptions()),\n    (data): BulkOperationResult => ({ records: data.records, success: true }),\n    { success: false } as BulkOperationResult\n  );\n\n  const { execute: bulkUpdate, loading: bulkUpdateLoading, error: bulkUpdateError } = useApiAsync(\n    (records: Partial<EntityRecord>[]) =>\n      bulkUpdateEntityRecordsApi(getEntityName(), records, getApiOptions()),\n    (data): BulkOperationResult => ({ records: data.records, success: true }),\n    { success: false } as BulkOperationResult\n  );\n\n  const { execute: bulkDelete, loading: bulkDeleteLoading, error: bulkDeleteError } = useApiAsync(\n    (recordIds: string[]) =>\n      bulkDeleteEntityRecordsApi(getEntityName(), recordIds, getApiOptions()),\n    (data) => data.success,\n    false\n  );\n\n  const loading =\n    queryLoading || getLoading || createLoading || updateLoading || deleteLoading ||\n    countLoading || bulkCreateLoading || bulkUpdateLoading || bulkDeleteLoading;\n\n  const error =\n    queryError || getError || createError || updateError || deleteError ||\n    countError || bulkCreateError || bulkUpdateError || bulkDeleteError;\n\n  return useMemo(\n    () => ({\n      loading,\n      error,\n      queryRecords,\n      getRecord,\n      createRecord,\n      updateRecord,\n      deleteRecord,\n      countRecords,\n      bulkCreate,\n      bulkUpdate,\n      bulkDelete,\n    }),\n    [\n      loading, error,\n      queryRecords, getRecord, createRecord, updateRecord, deleteRecord,\n      countRecords, bulkCreate, bulkUpdate, bulkDelete,\n    ]\n  );\n}\n","\"use client\";\n\n/**\n * Entity hooks for React applications\n *\n * Provides React hooks for entity CRUD operations with loading/error states.\n */\n\nimport { useState, useCallback } from \"react\";\nimport type { ApiClientOptions } from \"@elqnt/api-client\";\nimport type { EntityDefinition, EntityRecord } from \"../models\";\nimport {\n  listEntityDefinitionsApi,\n  getEntityDefinitionApi,\n  queryEntityRecordsApi,\n  getEntityRecordApi,\n  createEntityRecordApi,\n  updateEntityRecordApi,\n  deleteEntityRecordApi,\n} from \"../api\";\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport type UseEntitiesOptions = ApiClientOptions;\n\nexport interface QueryOptions {\n  page?: number;\n  pageSize?: number;\n  filters?: Record<string, unknown>;\n  sortBy?: string;\n  sortOrder?: \"asc\" | \"desc\";\n}\n\nexport interface QueryResult {\n  records: EntityRecord[];\n  total: number;\n  page: number;\n  pageSize: number;\n}\n\n// =============================================================================\n// USE ENTITIES HOOK\n// =============================================================================\n\n/**\n * Hook for entity CRUD operations\n *\n * @example\n * ```tsx\n * const { loading, error, queryRecords, createRecord } = useEntities({\n *   baseUrl: apiGatewayUrl,\n *   orgId: selectedOrgId,\n *   userId: user?.id,\n *   userEmail: user?.email,\n * });\n *\n * const records = await queryRecords(\"contacts\", { page: 1, pageSize: 20 });\n * ```\n */\nexport function useEntities(options: UseEntitiesOptions) {\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n\n  const listDefinitions = useCallback(async (): Promise<EntityDefinition[]> => {\n    setLoading(true);\n    setError(null);\n    try {\n      const response = await listEntityDefinitionsApi(options);\n      if (response.error) {\n        setError(response.error);\n        return [];\n      }\n      return response.data?.definitions || [];\n    } catch (err) {\n      const message = err instanceof Error ? err.message : \"Failed to load definitions\";\n      setError(message);\n      return [];\n    } finally {\n      setLoading(false);\n    }\n  }, [options]);\n\n  const getDefinition = useCallback(\n    async (entityName: string): Promise<EntityDefinition | null> => {\n      setLoading(true);\n      setError(null);\n      try {\n        const response = await getEntityDefinitionApi(entityName, options);\n        if (response.error) {\n          setError(response.error);\n          return null;\n        }\n        return response.data?.definition || null;\n      } catch (err) {\n        const message = err instanceof Error ? err.message : \"Failed to get definition\";\n        setError(message);\n        return null;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [options]\n  );\n\n  const queryRecords = useCallback(\n    async (entityName: string, query: QueryOptions = {}): Promise<QueryResult> => {\n      setLoading(true);\n      setError(null);\n      try {\n        const queryParams: Record<string, unknown> = {\n          page: query.page || 1,\n          pageSize: query.pageSize || 20,\n        };\n        if (query.filters) {\n          queryParams.filters = JSON.stringify(query.filters);\n        }\n        if (query.sortBy) {\n          queryParams.sortBy = query.sortBy;\n        }\n        if (query.sortOrder) {\n          queryParams.sortOrder = query.sortOrder;\n        }\n\n        const response = await queryEntityRecordsApi(entityName, queryParams, options);\n        if (response.error) {\n          setError(response.error);\n          return { records: [], total: 0, page: 1, pageSize: 20 };\n        }\n\n        // Handle both direct records array and nested ListResult structure\n        const data = response.data;\n        if (data?.records?.items) {\n          // ListEntityRecordsResponse with ListResult\n          return {\n            records: data.records.items,\n            total: data.records.totalCount,\n            page: data.records.currentPage,\n            pageSize: data.records.pageSize,\n          };\n        }\n        // Fallback for simpler response structure\n        return {\n          records: (data as any)?.records || [],\n          total: (data as any)?.total || 0,\n          page: (data as any)?.page || 1,\n          pageSize: (data as any)?.pageSize || 20,\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : \"Failed to query records\";\n        setError(message);\n        return { records: [], total: 0, page: 1, pageSize: 20 };\n      } finally {\n        setLoading(false);\n      }\n    },\n    [options]\n  );\n\n  const getRecord = useCallback(\n    async (entityName: string, recordId: string): Promise<EntityRecord | null> => {\n      setLoading(true);\n      setError(null);\n      try {\n        const response = await getEntityRecordApi(entityName, recordId, options);\n        if (response.error) {\n          setError(response.error);\n          return null;\n        }\n        return response.data?.record || null;\n      } catch (err) {\n        const message = err instanceof Error ? err.message : \"Failed to get record\";\n        setError(message);\n        return null;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [options]\n  );\n\n  const createRecord = useCallback(\n    async (entityName: string, record: Partial<EntityRecord>): Promise<EntityRecord | null> => {\n      setLoading(true);\n      setError(null);\n      try {\n        const response = await createEntityRecordApi(entityName, record, options);\n        if (response.error) {\n          setError(response.error);\n          return null;\n        }\n        return response.data?.record || null;\n      } catch (err) {\n        const message = err instanceof Error ? err.message : \"Failed to create record\";\n        setError(message);\n        return null;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [options]\n  );\n\n  const updateRecord = useCallback(\n    async (\n      entityName: string,\n      recordId: string,\n      record: Partial<EntityRecord>\n    ): Promise<EntityRecord | null> => {\n      setLoading(true);\n      setError(null);\n      try {\n        const response = await updateEntityRecordApi(entityName, recordId, record, options);\n        if (response.error) {\n          setError(response.error);\n          return null;\n        }\n        return response.data?.record || null;\n      } catch (err) {\n        const message = err instanceof Error ? err.message : \"Failed to update record\";\n        setError(message);\n        return null;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [options]\n  );\n\n  const deleteRecord = useCallback(\n    async (entityName: string, recordId: string): Promise<boolean> => {\n      setLoading(true);\n      setError(null);\n      try {\n        const response = await deleteEntityRecordApi(entityName, recordId, options);\n        if (response.error) {\n          setError(response.error);\n          return false;\n        }\n        return true;\n      } catch (err) {\n        const message = err instanceof Error ? err.message : \"Failed to delete record\";\n        setError(message);\n        return false;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [options]\n  );\n\n  return {\n    loading,\n    error,\n    listDefinitions,\n    getDefinition,\n    queryRecords,\n    getRecord,\n    createRecord,\n    updateRecord,\n    deleteRecord,\n  };\n}\n"],"mappings":"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","names":["useMemo","useMemo","useState","useCallback","useState","useCallback"]}

package/dist/hooks/index.d.mts

@@ -1,46 +1,141 @@
-import { ApiClientOptions } from '@elqnt/api-client';
-import { EntityRecord, EntityDefinition } from '../models/index.mjs';
+import { ApiClientOptions, ApiResponse } from '@elqnt/api-client';
+import { EntityDefinition, EntityRecord } from '../models/index.mjs';
+export { Q as QueryOptions, a as QueryResult, U as UseEntitiesOptions, u as useEntities } from '../use-entities-gK_B9I2n.mjs';
+import * as react from 'react';
 import '@elqnt/types';
 
-type UseEntitiesOptions = ApiClientOptions;
-interface QueryOptions {
+type UseEntityDefinitionsOptions = ApiClientOptions;
+/**
+ * Hook for entity definition CRUD operations
+ *
+ * @example
+ * ```tsx
+ * const { loading, error, listDefinitions, getDefinition, createDefinition } = useEntityDefinitions({
+ *   baseUrl: apiGatewayUrl,
+ *   orgId: selectedOrgId,
+ * });
+ *
+ * const definitions = await listDefinitions();
+ * const definition = await getDefinition("contacts");
+ * const newDef = await createDefinition({ name: "leads", title: "Leads" });
+ * ```
+ */
+declare function useEntityDefinitions(options: UseEntityDefinitionsOptions): {
+    loading: boolean;
+    error: string | null;
+    listDefinitions: () => Promise<EntityDefinition[]>;
+    getDefinition: (entityName: string) => Promise<EntityDefinition | null>;
+    createDefinition: (definition: Partial<EntityDefinition>) => Promise<EntityDefinition | null>;
+    updateDefinition: (entityName: string, definition: Partial<EntityDefinition>) => Promise<EntityDefinition | null>;
+    deleteDefinition: (entityName: string) => Promise<boolean>;
+};
+
+interface UseEntityRecordsOptions extends ApiClientOptions {
+    /** Entity name to operate on */
+    entityName: string;
+}
+interface QueryRecordsParams {
     page?: number;
     pageSize?: number;
     filters?: Record<string, unknown>;
     sortBy?: string;
     sortOrder?: "asc" | "desc";
 }
-interface QueryResult {
+interface QueryRecordsResult {
     records: EntityRecord[];
     total: number;
     page: number;
     pageSize: number;
 }
+interface BulkOperationResult {
+    records?: EntityRecord[];
+    success: boolean;
+}
 /**
- * Hook for entity CRUD operations
+ * Hook for entity record CRUD operations
  *
  * @example
  * ```tsx
- * const { loading, error, queryRecords, createRecord } = useEntities({
+ * const {
+ *   loading, error,
+ *   queryRecords, getRecord, createRecord, updateRecord, deleteRecord,
+ *   countRecords, bulkCreate, bulkUpdate, bulkDelete
+ * } = useEntityRecords({
  *   baseUrl: apiGatewayUrl,
  *   orgId: selectedOrgId,
- *   userId: user?.id,
- *   userEmail: user?.email,
+ *   entityName: "contacts",
  * });
  *
- * const records = await queryRecords("contacts", { page: 1, pageSize: 20 });
+ * const { records, total } = await queryRecords({ page: 1, pageSize: 20 });
+ * const record = await getRecord("record-id");
+ * const count = await countRecords({ status: "active" });
  * ```
  */
-declare function useEntities(options: UseEntitiesOptions): {
+declare function useEntityRecords(options: UseEntityRecordsOptions): {
     loading: boolean;
     error: string | null;
-    listDefinitions: () => Promise<EntityDefinition[]>;
-    getDefinition: (entityName: string) => Promise<EntityDefinition | null>;
-    queryRecords: (entityName: string, query?: QueryOptions) => Promise<QueryResult>;
-    getRecord: (entityName: string, recordId: string) => Promise<EntityRecord | null>;
-    createRecord: (entityName: string, record: Partial<EntityRecord>) => Promise<EntityRecord | null>;
-    updateRecord: (entityName: string, recordId: string, record: Partial<EntityRecord>) => Promise<EntityRecord | null>;
-    deleteRecord: (entityName: string, recordId: string) => Promise<boolean>;
+    queryRecords: (params?: QueryRecordsParams | undefined) => Promise<QueryRecordsResult>;
+    getRecord: (recordId: string) => Promise<EntityRecord | null>;
+    createRecord: (record: Partial<EntityRecord>) => Promise<EntityRecord | null>;
+    updateRecord: (recordId: string, record: Partial<EntityRecord>) => Promise<EntityRecord | null>;
+    deleteRecord: (recordId: string) => Promise<boolean>;
+    countRecords: (filters?: Record<string, unknown> | undefined) => Promise<number>;
+    bulkCreate: (records: Partial<EntityRecord>[]) => Promise<BulkOperationResult>;
+    bulkUpdate: (records: Partial<EntityRecord>[]) => Promise<BulkOperationResult>;
+    bulkDelete: (recordIds: string[]) => Promise<boolean>;
 };
 
-export { type QueryOptions, type QueryResult, type UseEntitiesOptions, useEntities };
+interface UseAsyncOptions {
+    /** Reset error on new request */
+    resetErrorOnRequest?: boolean;
+}
+interface UseAsyncReturn<TArgs extends unknown[], TResult> {
+    execute: (...args: TArgs) => Promise<TResult>;
+    loading: boolean;
+    error: string | null;
+}
+/**
+ * Generic async operation hook with loading/error states
+ *
+ * @example
+ * ```tsx
+ * const { execute: fetchUser, loading, error } = useAsync(
+ *   (userId: string) => getUserApi(userId, options),
+ *   (data) => data.user,
+ *   null
+ * );
+ *
+ * const user = await fetchUser("user-123");
+ * ```
+ */
+declare function useAsync<TArgs extends unknown[], TData, TResult>(asyncFn: (...args: TArgs) => Promise<ApiResponse<TData>>, transform: (data: TData) => TResult, defaultValue: TResult, options?: UseAsyncOptions): UseAsyncReturn<TArgs, TResult>;
+/**
+ * Simplified async hook for API operations
+ *
+ * @example
+ * ```tsx
+ * const { execute: getUsers, loading, error } = useApiAsync(
+ *   () => listUsersApi(optionsRef.current),
+ *   (data) => data.users,
+ *   []
+ * );
+ * ```
+ */
+declare function useApiAsync<TArgs extends unknown[], TData, TResult>(asyncFn: (...args: TArgs) => Promise<ApiResponse<TData>>, transform: (data: TData) => TResult, defaultValue: TResult): UseAsyncReturn<TArgs, TResult>;
+
+/**
+ * Hook that keeps options in a ref for stable callback access
+ *
+ * @example
+ * ```tsx
+ * const optionsRef = useOptionsRef({ baseUrl, orgId });
+ *
+ * const fetchData = useCallback(async () => {
+ *   // Always accesses latest options without recreating callback
+ *   await api.fetch(optionsRef.current);
+ * }, []); // No dependencies needed
+ * ```
+ */
+declare function useOptionsRef<T>(options: T): react.RefObject<T>;
+
+export { type BulkOperationResult, type QueryRecordsParams, type QueryRecordsResult, type UseAsyncOptions, type UseAsyncReturn, type UseEntityDefinitionsOptions, type UseEntityRecordsOptions, useApiAsync, useAsync, useEntityDefinitions, useEntityRecords, useOptionsRef };