@simpleapps-com/augur-server 0.2.12 → 0.2.13

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { QueryClient } from '@tanstack/react-query';
 export { QueryOptionsConfig, createQueryOptions, createSuspenseQueryOptions } from './query.js';
-export { A as AgrInfoActions, a as AgrInfoActionsConfig, b as AgrInfoApiClient, c as AgrSiteActions, d as AgrSiteActionsConfig, e as AgrSiteApiClient, f as AgrWorkActions, g as AgrWorkActionsConfig, h as AgrWorkApiClient, i as AvalaraActions, j as AvalaraActionsConfig, k as AvalaraApiClient, B as Basecamp2Actions, l as Basecamp2ActionsConfig, m as Basecamp2ApiClient, n as BrandFolderActions, o as BrandFolderActionsConfig, p as BrandFolderApiClient, C as CommerceActions, q as CommerceActionsConfig, r as CommerceApiClient, s as CustomersActions, t as CustomersActionsConfig, u as CustomersApiClient, G as GregorovichActions, v as GregorovichActionsConfig, w as GregorovichApiClient, I as ItemActions, x as ItemActionsConfig, y as ItemsApiClient, J as JoomlaActions, z as JoomlaActionsConfig, D as JoomlaApiClient, L as LegacyActions, E as LegacyActionsConfig, F as LegacyApiClient, H as LogisticsActions, K as LogisticsActionsConfig, M as LogisticsApiClient, N as NexusActions, O as NexusActionsConfig, P as NexusApiClient, Q as OrderActions, R as OrderActionsConfig, S as OrderApiClient, T as P21ApisActions, U as P21ApisActionsConfig, V as P21ApisApiClient, W as P21CoreActions, X as P21CoreActionsConfig, Y as P21CoreApiClient, Z as P21PimActions, _ as P21PimActionsConfig, $ as P21PimApiClient, a0 as P21SismActions, a1 as P21SismActionsConfig, a2 as P21SismApiClient, a3 as PaymentsActions, a4 as PaymentsActionsConfig, a5 as PaymentsApiClient, a6 as PricingActions, a7 as PricingActionsConfig, a8 as PricingApiClient, a9 as SearchActions, aa as SearchActionsConfig, ab as SearchApiClient, ac as SearchPage, ad as ShippingActions, ae as ShippingActionsConfig, af as ShippingAddress, ag as ShippingApiClient, ah as SiteActions, ai as SiteActionsConfig, aj as SlackActions, ak as SlackActionsConfig, al as SlackApiClient, am as SmartyStreetsActions, an as SmartyStreetsActionsConfig, ao as SmartyStreetsApiClient, ap as UpsActions, aq as UpsActionsConfig, ar as UpsApiClient, as as VmiActions, at as VmiActionsConfig, au as VmiApiClient, av as createAgrInfoActions, aw as createAgrSiteActions, ax as createAgrWorkActions, ay as createAvalaraActions, az as createBasecamp2Actions, aA as createBrandFolderActions, aB as createCommerceActions, aC as createCustomersActions, aD as createGregorovichActions, aE as createItemActions, aF as createJoomlaActions, aG as createLegacyActions, aH as createLogisticsActions, aI as createNexusActions, aJ as createOrderActions, aK as createP21ApisActions, aL as createP21CoreActions, aM as createP21PimActions, aN as createP21SismActions, aO as createPaymentsActions, aP as createPricingActions, aQ as createSearchActions, aR as createShippingActions, aS as createSiteActions, aT as createSlackActions, aU as createSmartyStreetsActions, aV as createUpsActions, aW as createVmiActions } from './site-CZvrFj_i.js';
+export { A as AddressValidationResult, a as AgrInfoActions, b as AgrInfoActionsConfig, c as AgrInfoApiClient, d as AgrSiteActions, e as AgrSiteActionsConfig, f as AgrSiteApiClient, g as AgrWorkActions, h as AgrWorkActionsConfig, i as AgrWorkApiClient, j as AvalaraActions, k as AvalaraActionsConfig, l as AvalaraApiClient, B as Basecamp2Actions, m as Basecamp2ActionsConfig, n as Basecamp2ApiClient, o as BrandFolderActions, p as BrandFolderActionsConfig, q as BrandFolderApiClient, C as CommerceActions, r as CommerceActionsConfig, s as CommerceApiClient, t as CustomersActions, u as CustomersActionsConfig, v as CustomersApiClient, G as GregorovichActions, w as GregorovichActionsConfig, x as GregorovichApiClient, I as ItemActions, y as ItemActionsConfig, z as ItemsApiClient, J as JoomlaActions, D as JoomlaActionsConfig, E as JoomlaApiClient, L as LegacyActions, F as LegacyActionsConfig, H as LegacyApiClient, K as LogisticsActions, M as LogisticsActionsConfig, N as LogisticsApiClient, O as NexusActions, P as NexusActionsConfig, Q as NexusApiClient, R as OrderActions, S as OrderActionsConfig, T as OrderApiClient, U as P21ApisActions, V as P21ApisActionsConfig, W as P21ApisApiClient, X as P21CoreActions, Y as P21CoreActionsConfig, Z as P21CoreApiClient, _ as P21PimActions, $ as P21PimActionsConfig, a0 as P21PimApiClient, a1 as P21SismActions, a2 as P21SismActionsConfig, a3 as P21SismApiClient, a4 as PaymentsActions, a5 as PaymentsActionsConfig, a6 as PaymentsApiClient, a7 as PricingActions, a8 as PricingActionsConfig, a9 as PricingApiClient, aa as SearchActions, ab as SearchActionsConfig, ac as SearchApiClient, ad as SearchPage, ae as ShippingActions, af as ShippingActionsConfig, ag as ShippingAddress, ah as ShippingApiClient, ai as SiteActions, aj as SiteActionsConfig, ak as SlackActions, al as SlackActionsConfig, am as SlackApiClient, an as SmartyStreetsActions, ao as SmartyStreetsActionsConfig, ap as SmartyStreetsApiClient, aq as UpsActions, ar as UpsActionsConfig, as as UpsApiClient, at as VmiActions, au as VmiActionsConfig, av as VmiApiClient, aw as createAgrInfoActions, ax as createAgrSiteActions, ay as createAgrWorkActions, az as createAvalaraActions, aA as createBasecamp2Actions, aB as createBrandFolderActions, aC as createCommerceActions, aD as createCustomersActions, aE as createGregorovichActions, aF as createItemActions, aG as createJoomlaActions, aH as createLegacyActions, aI as createLogisticsActions, aJ as createNexusActions, aK as createOrderActions, aL as createP21ApisActions, aM as createP21CoreActions, aN as createP21PimActions, aO as createP21SismActions, aP as createPaymentsActions, aQ as createPricingActions, aR as createSearchActions, aS as createShippingActions, aT as createSiteActions, aU as createSlackActions, aV as createSmartyStreetsActions, aW as createUpsActions, aX as createVmiActions } from './site-DibGofHe.js';
 import '@simpleapps-com/augur-utils';
 
 declare const env: "development" | "staging" | "production";
@@ -113,4 +113,36 @@ declare const getServerQueryClient: () => QueryClient;
  */
 declare function withServerCache<T>(prefix: string, redisTtl: number | undefined, methodPath: string, fn: () => Promise<T>, ...keyArgs: unknown[]): Promise<T>;
 
-export { type ActionResult, cacheGet, cacheSet, createServerQueryClient, env, getCircuitState, getServerQueryClient, isDev, isProduction, isRedisConnected, isStaging, safeAction, sdkCall, withServerCache };
+/**
+ * Standardized paginated response shape.
+ * Works with any factory method — compose with `paginateOffset()`.
+ */
+interface PaginatedResult<T> {
+    data: T[];
+    total?: number;
+    nextCursor?: number;
+    hasMore: boolean;
+}
+/**
+ * Wraps a list of items with offset-based pagination metadata.
+ *
+ * Use this to standardize pagination responses from any factory method.
+ * Compatible with React Query's infinite query pattern (`getNextPageParam`).
+ *
+ * @param items - The items returned from the current page
+ * @param pageParam - The current page number (0-based)
+ * @param limit - The page size
+ * @param total - Optional total count of items (from API response)
+ *
+ * @example
+ * ```ts
+ * const result = await actions.items.getCategoryItems(uid, {
+ *   ...filters, offset: page * 24, limit: 24,
+ * });
+ * return paginateOffset(result.items, page, 24, result.total);
+ * // { data: [...], total: 150, nextCursor: 1, hasMore: true }
+ * ```
+ */
+declare function paginateOffset<T>(items: T[], pageParam: number, limit: number, total?: number): PaginatedResult<T>;
+
+export { type ActionResult, type PaginatedResult, cacheGet, cacheSet, createServerQueryClient, env, getCircuitState, getServerQueryClient, isDev, isProduction, isRedisConnected, isStaging, paginateOffset, safeAction, sdkCall, withServerCache };

package/dist/index.js

@@ -187,6 +187,17 @@ async function withServerCache(prefix, redisTtl, methodPath, fn, ...keyArgs) {
   return result;
 }
 
+// src/pagination.ts
+function paginateOffset(items, pageParam, limit, total) {
+  const hasMore = total !== void 0 ? (pageParam + 1) * limit < total : items.length === limit;
+  return {
+    data: items,
+    total,
+    nextCursor: hasMore ? pageParam + 1 : void 0,
+    hasMore
+  };
+}
+
 // src/actions/pricing.ts
 function resolveCustomerId(explicit, fallback) {
   const raw = explicit ?? fallback;
@@ -250,7 +261,8 @@ function createItemActions(api, config = {}) {
     longEdgeCache = 8,
     redisTtl = 3600,
     longRedisTtl = 28800,
-    sortChildren = true
+    sortChildren = true,
+    sortByPrefix
   } = config;
   function sortCategoryChildren(children) {
     if (!sortChildren) return children;
@@ -292,19 +304,23 @@ function createItemActions(api, config = {}) {
     };
   }
   async function getCategoryItems(uid, filters) {
+    const merged = { ...filters };
+    if (sortByPrefix && typeof merged.sortBy === "string" && merged.sortBy) {
+      merged.sortBy = `${sortByPrefix}${merged.sortBy}`;
+    }
     return withServerCache(
       cachePrefix,
       redisTtl,
       "items.categories.items.list",
       async () => {
         const response = await api.items.categories.items.list(uid, {
-          ...filters,
+          ...merged,
           edgeCache
         });
         return response.data;
       },
       uid,
-      filters
+      merged
     );
   }
   async function getItemAttributes(categoryUid) {
@@ -930,8 +946,17 @@ function createCustomersActions(api, config = {}) {
 function createSmartyStreetsActions(api, config = {}) {
   const { cachePrefix: _cachePrefix = "" } = config;
   async function validateAddress(params) {
-    const response = await api.smartyStreets.us.lookup.get(params);
-    return response.data;
+    try {
+      const response = await api.smartyStreets.us.lookup.get(params);
+      const data = response.data;
+      if (data) {
+        return { data, status: "success" };
+      }
+      return { data: void 0, status: "not_found" };
+    } catch (e) {
+      const message = e instanceof Error ? e.message : String(e);
+      return { data: void 0, status: "error", error: { message } };
+    }
   }
   return {
     validateAddress
@@ -1033,10 +1058,13 @@ function createAvalaraActions(api, config = {}) {
 
 // src/actions/payments.ts
 function createPaymentsActions(api, config = {}) {
-  const { cachePrefix: _cachePrefix = "" } = config;
+  const { cachePrefix: _cachePrefix = "", mode = "live" } = config;
+  function withMode(params) {
+    return { mode, ...params };
+  }
   async function transactionSetup(params) {
     try {
-      const response = await api.payments.unified.transactionSetup.get(params);
+      const response = await api.payments.unified.transactionSetup.get(withMode(params));
       return response.data;
     } catch {
       return void 0;
@@ -1044,7 +1072,7 @@ function createPaymentsActions(api, config = {}) {
   }
   async function accountQuery(params) {
     try {
-      const response = await api.payments.unified.accountQuery.get(params);
+      const response = await api.payments.unified.accountQuery.get(withMode(params));
       return response.data;
     } catch {
       return void 0;
@@ -1052,7 +1080,7 @@ function createPaymentsActions(api, config = {}) {
   }
   async function getSurcharge(params) {
     try {
-      const response = await api.payments.unified.surcharge.get(params);
+      const response = await api.payments.unified.surcharge.get(withMode(params));
       return response.data;
     } catch {
       return void 0;
@@ -1060,7 +1088,7 @@ function createPaymentsActions(api, config = {}) {
   }
   async function cardInfo(params) {
     try {
-      const response = await api.payments.unified.cardInfo.get(params);
+      const response = await api.payments.unified.cardInfo.get(withMode(params));
       return response.data;
     } catch {
       return void 0;
@@ -1068,7 +1096,7 @@ function createPaymentsActions(api, config = {}) {
   }
   async function billingUpdate(params) {
     try {
-      const response = await api.payments.unified.billingUpdate.get(params);
+      const response = await api.payments.unified.billingUpdate.get(withMode(params));
       return response.data;
     } catch {
       return void 0;
@@ -1076,7 +1104,7 @@ function createPaymentsActions(api, config = {}) {
   }
   async function validatePayment(params) {
     try {
-      const response = await api.payments.unified.validate.get(params);
+      const response = await api.payments.unified.validate.get(withMode(params));
       return response.data;
     } catch {
       return void 0;
@@ -2158,7 +2186,10 @@ function createSiteActions(api, config = {}) {
     () => createAvalaraActions(castApi(), { cachePrefix })
   );
   const payments = lazy(
-    () => createPaymentsActions(castApi(), { cachePrefix })
+    () => createPaymentsActions(castApi(), {
+      cachePrefix,
+      ...config.payments
+    })
   );
   const ups = lazy(
     () => createUpsActions(castApi(), { cachePrefix })
@@ -2324,6 +2355,7 @@ export {
   isProduction,
   isRedisConnected,
   isStaging,
+  paginateOffset,
   safeAction,
   sdkCall,
   withServerCache