@simpleapps-com/augur-hooks 0.2.17 → 0.3.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { G as GetItemCategoryApiOptions, P as PageData, S as SearchSuggestionsResponse, a as SearchSuggestion, I as InfiniteScrollPage, A as AugurCallbacks, C as CacheConfig, b as AugurApiClient, c as AugurAuthContext, d as PersistenceConfig } from './joomla-content-list-DGPtwJ99.js';
-export { e as AugurHooksProvider, f as CacheProvider, g as CacheTierConfig, h as getCartPricingQueryOptions, i as getCategoryItemsInfiniteKey, j as getCategoryItemsInfiniteOptions, k as getInvMastDocKey, l as getInvMastDocOptions, m as getInvMastKey, n as getInvMastOptions, o as getInvMastStockKey, p as getInvMastStockOptions, q as getItemAttributesKey, r as getItemAttributesOptions, s as getItemCategoryKey, t as getItemCategoryOptions, u as getItemDetailsKey, v as getItemDetailsOptions, w as getItemPriceKey, x as getItemPriceOptions, y as getItemSearchInfiniteKey, z as getItemSearchInfiniteOptions, B as getJoomlaContentKey, D as getJoomlaContentListKey, E as getJoomlaContentListOptions, F as getJoomlaContentOptions, H as getProductCategoryKey, J as getProductCategoryOptions, K as getProductSearchKey, L as getProductSearchOptions, M as getSearchSuggestionsKey, N as getSearchSuggestionsOptions, O as useAugurApi, Q as useAugurAuth, R as useAugurCache } from './joomla-content-list-DGPtwJ99.js';
+import { G as GetItemCategoryApiOptions, P as PageData, S as SearchSuggestionsResponse, a as SearchSuggestion, I as InfiniteScrollPage, A as AugurCallbacks, C as CacheConfig, b as AugurApiClient, c as AugurAuthContext, d as PersistenceConfig } from './joomla-menu-doc-C0Dcq1eO.js';
+export { e as AugurHooksProvider, f as CacheProvider, g as CacheTierConfig, h as getCartPricingQueryOptions, i as getCategoryItemsInfiniteKey, j as getCategoryItemsInfiniteOptions, k as getInvMastDocKey, l as getInvMastDocOptions, m as getInvMastKey, n as getInvMastOptions, o as getInvMastStockKey, p as getInvMastStockOptions, q as getItemAttributesKey, r as getItemAttributesOptions, s as getItemCategoryKey, t as getItemCategoryOptions, u as getItemDetailsKey, v as getItemDetailsOptions, w as getItemPriceKey, x as getItemPriceOptions, y as getItemSearchInfiniteKey, z as getItemSearchInfiniteOptions, B as getJoomlaContentKey, D as getJoomlaContentListKey, E as getJoomlaContentListOptions, F as getJoomlaContentOptions, H as getJoomlaMenuDocKey, J as getJoomlaMenuDocOptions, K as getJoomlaMenuKey, L as getJoomlaMenuOptions, M as getProductCategoryKey, N as getProductCategoryOptions, O as getProductSearchKey, Q as getProductSearchOptions, R as getSearchSuggestionsKey, T as getSearchSuggestionsOptions, U as useAugurApi, V as useAugurApiOptional, W as useAugurAuth, X as useAugurCache } from './joomla-menu-doc-C0Dcq1eO.js';
 import * as zustand from 'zustand';
-import { TCartLine, TItemsFilters, TPriceData, TInvMastDoc, TCategory, TItemDetails, TAttribute, TJoomlaContent, TJoomlaContentFilters } from '@simpleapps-com/augur-utils';
+import { TCartLine, TItemsFilters, TPriceData, TInvMastDoc, TCategory, TItemDetails, TAttribute, TJoomlaContent, TJoomlaContentFilters, MenuItem, TMenuFilters } from '@simpleapps-com/augur-utils';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryKey } from '@tanstack/react-query';
 import { ReactNode, createElement } from 'react';
@@ -11,7 +11,8 @@ import 'react/jsx-runtime';
 interface CartState {
     cartHdrUid: number | string | undefined;
     cartLines: TCartLine[];
-    cartItemCount: number;
+    cartQuantityTotal: number;
+    cartLineCount: number;
     setCartHdrUid: (cartHdrUid: number | string | undefined) => void;
     setCartLines: (cartLines: TCartLine[]) => void;
     clearCart: () => void;
@@ -35,7 +36,8 @@ declare const useCartStore: zustand.UseBoundStore<Omit<zustand.StoreApi<CartStat
 }>;
 declare const useCartHdrUid: () => string | number | undefined;
 declare const useCartLines: () => TCartLine[];
-declare const useCartItemCount: () => number;
+declare const useCartQuantityTotal: () => number;
+declare const useCartLineCount: () => number;
 declare const useSetCartHdrUid: () => (cartHdrUid: number | string | undefined) => void;
 declare const useSetCartLines: () => (cartLines: TCartLine[]) => void;
 declare const useClearCart: () => () => void;
@@ -456,6 +458,27 @@ declare function useJoomlaContentList(categoryId: number | string | undefined, o
     error: Error | null;
 };
 
+interface UseJoomlaMenuOptions {
+    enabled?: boolean;
+    queryFn?: () => Promise<MenuItem[]>;
+    filters?: Partial<TMenuFilters>;
+}
+declare function useJoomlaMenu(options?: UseJoomlaMenuOptions): {
+    menuItems: MenuItem[];
+    isLoading: boolean;
+    error: Error | null;
+};
+
+interface UseJoomlaMenuDocOptions {
+    enabled?: boolean;
+    queryFn?: () => Promise<MenuItem>;
+}
+declare function useJoomlaMenuDoc(menuId: number | string | undefined, options?: UseJoomlaMenuDocOptions): {
+    menuItem: MenuItem | null;
+    isLoading: boolean;
+    error: Error | null;
+};
+
 /**
  * Factory function that creates a pre-configured provider + hook bundle,
  * eliminating per-hook wrapper boilerplate in consumer sites.
@@ -490,8 +513,8 @@ interface CreateSiteHooksConfig {
     cache?: CacheConfig;
 }
 interface SiteHooksProviderProps {
-    /** The augur-api SDK instance. */
-    api: AugurApiClient;
+    /** SDK client instance. Optional when all data fetching is routed through callbacks. */
+    api?: AugurApiClient;
     /** Auth context (partial -- missing fields are filled from config defaults). */
     auth?: Partial<AugurAuthContext>;
     children: ReactNode;
@@ -516,6 +539,8 @@ interface SiteHooks {
     useItemSearchInfinite: typeof useItemSearchInfinite;
     useJoomlaContent: typeof useJoomlaContent;
     useJoomlaContentList: typeof useJoomlaContentList;
+    useJoomlaMenu: typeof useJoomlaMenu;
+    useJoomlaMenuDoc: typeof useJoomlaMenuDoc;
     useDebounce: typeof useDebounce;
     useFormatPrice: typeof useFormatPrice;
 }
@@ -578,4 +603,4 @@ declare function useAugurPersistence(config: PersistenceConfig): {
     };
 };
 
-export { AugurApiClient, AugurAuthContext, AugurCallbacks, CacheConfig, type CartActionCallbacks, type CartInitCallbacks, type CartPriceData, type CartPricingResult, type CartSessionInfo, type CreateSiteHooksConfig, GetItemCategoryApiOptions, InfiniteScrollPage, PageData, PersistenceConfig, SearchSuggestion, SearchSuggestionsResponse, createSiteHooks, useAugurPersistence, useCartActions, useCartHdrUid, useCartInitialization, useCartItemCount, useCartLines, useCartPricing, useCartStore, useCategoryItemsInfinite, useClearCart, useDebounce, useFormatPrice, useInvMast, useInvMastDoc, useInvMastStock, useItemAttributes, useItemCategory, useItemDetails, useItemFiltersStore, useItemPrice, useItemSearchInfinite, useJoomlaContent, useJoomlaContentList, usePaginationPrefetch, useProductCategory, useProductSearch, useSearchSuggestions, useSetCartHdrUid, useSetCartLines };
+export { AugurApiClient, AugurAuthContext, AugurCallbacks, CacheConfig, type CartActionCallbacks, type CartInitCallbacks, type CartPriceData, type CartPricingResult, type CartSessionInfo, type CreateSiteHooksConfig, GetItemCategoryApiOptions, InfiniteScrollPage, PageData, PersistenceConfig, SearchSuggestion, SearchSuggestionsResponse, createSiteHooks, useAugurPersistence, useCartActions, useCartHdrUid, useCartInitialization, useCartLineCount, useCartLines, useCartPricing, useCartQuantityTotal, useCartStore, useCategoryItemsInfinite, useClearCart, useDebounce, useFormatPrice, useInvMast, useInvMastDoc, useInvMastStock, useItemAttributes, useItemCategory, useItemDetails, useItemFiltersStore, useItemPrice, useItemSearchInfinite, useJoomlaContent, useJoomlaContentList, useJoomlaMenu, useJoomlaMenuDoc, usePaginationPrefetch, useProductCategory, useProductSearch, useSearchSuggestions, useSetCartHdrUid, useSetCartLines };

package/dist/index.js

@@ -22,13 +22,17 @@ import {
   getJoomlaContentListKey,
   getJoomlaContentListOptions,
   getJoomlaContentOptions,
+  getJoomlaMenuDocKey,
+  getJoomlaMenuDocOptions,
+  getJoomlaMenuKey,
+  getJoomlaMenuOptions,
   getProductCategoryKey,
   getProductCategoryOptions,
   getProductSearchKey,
   getProductSearchOptions,
   getSearchSuggestionsKey,
   getSearchSuggestionsOptions
-} from "./chunk-XPZVNYPR.js";
+} from "./chunk-LCWJOWAC.js";
 
 // src/provider.tsx
 import { createContext, useContext } from "react";
@@ -48,7 +52,15 @@ function AugurHooksProvider({
   cache,
   children
 }) {
-  return /* @__PURE__ */ jsx(AugurApiContext.Provider, { value: api, children: /* @__PURE__ */ jsx(AugurCallbacksContext.Provider, { value: callbacks, children: /* @__PURE__ */ jsx(AugurAuthReactContext.Provider, { value: auth, children: /* @__PURE__ */ jsx(AugurCacheContext.Provider, { value: cache, children }) }) }) });
+  if (process.env.NODE_ENV === "development" && !api && !callbacks) {
+    console.warn(
+      "AugurHooksProvider: neither `api` nor `callbacks` provided. Hooks will fail at runtime unless every hook receives a queryFn override."
+    );
+  }
+  return /* @__PURE__ */ jsx(AugurApiContext.Provider, { value: api ?? null, children: /* @__PURE__ */ jsx(AugurCallbacksContext.Provider, { value: callbacks, children: /* @__PURE__ */ jsx(AugurAuthReactContext.Provider, { value: auth, children: /* @__PURE__ */ jsx(AugurCacheContext.Provider, { value: cache, children }) }) }) });
+}
+function useAugurApiOptional() {
+  return useContext(AugurApiContext);
 }
 function useAugurApi() {
   const api = useContext(AugurApiContext);
@@ -77,17 +89,19 @@ var useCartStore = create()(
     (set) => ({
       cartHdrUid: void 0,
       cartLines: [],
-      cartItemCount: 0,
+      cartQuantityTotal: 0,
+      cartLineCount: 0,
       setCartHdrUid: (cartHdrUid) => set({ cartHdrUid }, false, "setCartHdrUid"),
       setCartLines: (cartLines) => {
-        const cartItemCount = cartLines.reduce(
+        const cartQuantityTotal = cartLines.reduce(
           (sum, line) => sum + (line.quantity || 0),
           0
         );
-        set({ cartLines, cartItemCount }, false, "setCartLines");
+        const cartLineCount = cartLines.length;
+        set({ cartLines, cartQuantityTotal, cartLineCount }, false, "setCartLines");
       },
       clearCart: () => set(
-        { cartHdrUid: void 0, cartLines: [], cartItemCount: 0 },
+        { cartHdrUid: void 0, cartLines: [], cartQuantityTotal: 0, cartLineCount: 0 },
         false,
         "clearCart"
       )
@@ -97,7 +111,8 @@ var useCartStore = create()(
 );
 var useCartHdrUid = () => useCartStore((s) => s.cartHdrUid);
 var useCartLines = () => useCartStore((s) => s.cartLines);
-var useCartItemCount = () => useCartStore((s) => s.cartItemCount);
+var useCartQuantityTotal = () => useCartStore((s) => s.cartQuantityTotal);
+var useCartLineCount = () => useCartStore((s) => s.cartLineCount);
 var useSetCartHdrUid = () => useCartStore((s) => s.setCartHdrUid);
 var useSetCartLines = () => useCartStore((s) => s.setCartLines);
 var useClearCart = () => useCartStore((s) => s.clearCart);
@@ -157,7 +172,7 @@ function useFormatPrice(locale = "en-US", currency = "USD") {
 // src/hooks/use-item-price.ts
 import { useQuery } from "@tanstack/react-query";
 function useItemPrice(itemId, customerId, quantity = 1, options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const auth = useAugurAuth();
   const cache = useAugurCache();
@@ -175,7 +190,7 @@ function useItemPrice(itemId, customerId, quantity = 1, options = {}) {
 // src/hooks/use-inv-mast-doc.ts
 import { useQuery as useQuery2 } from "@tanstack/react-query";
 function useInvMastDoc(invMastUid, itemId, options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const cache = useAugurCache();
   const queryOpts = getInvMastDocOptions(
@@ -197,7 +212,7 @@ function useInvMastDoc(invMastUid, itemId, options = {}) {
 // src/hooks/use-item-category.ts
 import { useQuery as useQuery3 } from "@tanstack/react-query";
 function useItemCategory(itemCategoryUid, options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const cache = useAugurCache();
   const queryOpts = getItemCategoryOptions(
@@ -217,7 +232,7 @@ function useItemCategory(itemCategoryUid, options = {}) {
 // src/hooks/use-inv-mast.ts
 import { useQuery as useQuery4 } from "@tanstack/react-query";
 function useInvMast(invMastUid, itemId, options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const cache = useAugurCache();
   const queryOpts = getInvMastOptions(api, invMastUid, itemId, cache);
@@ -232,7 +247,7 @@ function useInvMast(invMastUid, itemId, options = {}) {
 // src/hooks/use-inv-mast-stock.ts
 import { useQuery as useQuery5 } from "@tanstack/react-query";
 function useInvMastStock(invMastUid, options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const cache = useAugurCache();
   const queryOpts = getInvMastStockOptions(api, invMastUid, cache);
@@ -263,7 +278,7 @@ function resolveData(data) {
   };
 }
 function useProductCategory(itemCategoryUid, options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const cache = useAugurCache();
   const baseOptions = itemCategoryUid ? getProductCategoryOptions(api, itemCategoryUid, cache) : {
@@ -291,7 +306,7 @@ function useProductCategory(itemCategoryUid, options = {}) {
 // src/hooks/use-item-details.ts
 import { useQuery as useQuery7 } from "@tanstack/react-query";
 function useItemDetails(itemId, options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const cache = useAugurCache();
   const { data, isLoading, error } = useQuery7({
@@ -319,7 +334,7 @@ function useItemDetails(itemId, options = {}) {
 // src/hooks/use-item-attributes.ts
 import { useQuery as useQuery8 } from "@tanstack/react-query";
 function useItemAttributes(itemCategoryUid, options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const cache = useAugurCache();
   const { data, isLoading, error } = useQuery8({
@@ -345,7 +360,7 @@ function useItemAttributes(itemCategoryUid, options = {}) {
 // src/hooks/use-product-search.ts
 import { useQuery as useQuery9 } from "@tanstack/react-query";
 function useProductSearch(pageData, options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const cache = useAugurCache();
   const defaultOptions = getProductSearchOptions(api, pageData, cache);
@@ -368,7 +383,7 @@ function useProductSearch(pageData, options = {}) {
 // src/hooks/use-search-suggestions.ts
 import { useQuery as useQuery10 } from "@tanstack/react-query";
 function useSearchSuggestions(query, options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const cache = useAugurCache();
   const limit = options.limit ?? 10;
@@ -675,7 +690,7 @@ function useCartInitialization(session, callbacks) {
 import { useMemo as useMemo2 } from "react";
 import { useQueries } from "@tanstack/react-query";
 function useCartPricing(options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const auth = useAugurAuth();
   const cache = useAugurCache();
@@ -786,7 +801,7 @@ var usePaginationPrefetch = ({
 // src/hooks/use-category-items-infinite.ts
 import { useInfiniteQuery } from "@tanstack/react-query";
 function useCategoryItemsInfinite(itemCategoryUid, itemsFilters, options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const cache = useAugurCache();
   const { enabled = true } = options;
@@ -813,7 +828,7 @@ function useCategoryItemsInfinite(itemCategoryUid, itemsFilters, options = {}) {
 // src/hooks/use-item-search-infinite.ts
 import { useInfiniteQuery as useInfiniteQuery2 } from "@tanstack/react-query";
 function useItemSearchInfinite(itemsFilters, itemCategoryUid, options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const cache = useAugurCache();
   const { enabled = true } = options;
@@ -840,7 +855,7 @@ function useItemSearchInfinite(itemsFilters, itemCategoryUid, options = {}) {
 // src/hooks/use-joomla-content.ts
 import { useQuery as useQuery12 } from "@tanstack/react-query";
 function useJoomlaContent(articleId, options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const cache = useAugurCache();
   const { data, isLoading, error } = useQuery12({
@@ -862,7 +877,7 @@ function useJoomlaContent(articleId, options = {}) {
 // src/hooks/use-joomla-content-list.ts
 import { useQuery as useQuery13 } from "@tanstack/react-query";
 function useJoomlaContentList(categoryId, options = {}) {
-  const api = useAugurApi();
+  const api = useAugurApiOptional();
   const callbacks = useAugurCallbacks();
   const cache = useAugurCache();
   const { data, isLoading, error } = useQuery13({
@@ -883,6 +898,48 @@ function useJoomlaContentList(categoryId, options = {}) {
   };
 }
 
+// src/hooks/use-joomla-menu.ts
+import { useQuery as useQuery14 } from "@tanstack/react-query";
+function useJoomlaMenu(options = {}) {
+  const api = useAugurApiOptional();
+  const callbacks = useAugurCallbacks();
+  const cache = useAugurCache();
+  const { data, isLoading, error } = useQuery14({
+    ...getJoomlaMenuOptions(api, options.filters, cache),
+    ...options.queryFn ?? callbacks?.getJoomlaMenu ? {
+      queryFn: options.queryFn ?? (() => callbacks.getJoomlaMenu(options.filters))
+    } : {},
+    enabled: options.enabled ?? true
+  });
+  return {
+    menuItems: data ?? [],
+    isLoading,
+    error
+  };
+}
+
+// src/hooks/use-joomla-menu-doc.ts
+import { useQuery as useQuery15 } from "@tanstack/react-query";
+function useJoomlaMenuDoc(menuId, options = {}) {
+  const api = useAugurApiOptional();
+  const callbacks = useAugurCallbacks();
+  const cache = useAugurCache();
+  const { data, isLoading, error } = useQuery15({
+    ...menuId ? getJoomlaMenuDocOptions(api, menuId, cache) : {
+      queryKey: getJoomlaMenuDocKey(""),
+      /* v8 ignore next */
+      queryFn: () => Promise.reject()
+    },
+    ...options.queryFn ?? callbacks?.getJoomlaMenuDoc ? { queryFn: options.queryFn ?? (() => callbacks.getJoomlaMenuDoc(menuId)) } : {},
+    enabled: (options.enabled ?? true) && !!menuId
+  });
+  return {
+    menuItem: data ?? null,
+    isLoading,
+    error
+  };
+}
+
 // src/create-site-hooks.ts
 import { createElement } from "react";
 function createSiteHooks(config = {}) {
@@ -930,6 +987,8 @@ function createSiteHooks(config = {}) {
     // Hooks -- Joomla
     useJoomlaContent,
     useJoomlaContentList,
+    useJoomlaMenu,
+    useJoomlaMenuDoc,
     // Hooks -- utilities
     useDebounce,
     useFormatPrice
@@ -1123,6 +1182,10 @@ export {
   getJoomlaContentListKey,
   getJoomlaContentListOptions,
   getJoomlaContentOptions,
+  getJoomlaMenuDocKey,
+  getJoomlaMenuDocOptions,
+  getJoomlaMenuKey,
+  getJoomlaMenuOptions,
   getProductCategoryKey,
   getProductCategoryOptions,
   getProductSearchKey,
@@ -1130,15 +1193,17 @@ export {
   getSearchSuggestionsKey,
   getSearchSuggestionsOptions,
   useAugurApi,
+  useAugurApiOptional,
   useAugurAuth,
   useAugurCache,
   useAugurPersistence,
   useCartActions,
   useCartHdrUid,
   useCartInitialization,
-  useCartItemCount,
+  useCartLineCount,
   useCartLines,
   useCartPricing,
+  useCartQuantityTotal,
   useCartStore,
   useCategoryItemsInfinite,
   useClearCart,
@@ -1155,6 +1220,8 @@ export {
   useItemSearchInfinite,
   useJoomlaContent,
   useJoomlaContentList,
+  useJoomlaMenu,
+  useJoomlaMenuDoc,
   usePaginationPrefetch,
   useProductCategory,
   useProductSearch,