@simpleapps-com/augur-hooks 2.4.0 → 2026.11.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/EXPORTS.md +25 -65
- package/README.md +21 -246
- package/dist/checkout/create-checkout-provider.d.ts +25 -0
- package/dist/checkout/create-checkout-provider.d.ts.map +1 -0
- package/dist/checkout/index.cjs +123 -106
- package/dist/checkout/index.cjs.map +1 -1
- package/dist/checkout/index.d.ts +5 -293
- package/dist/checkout/index.d.ts.map +1 -0
- package/dist/checkout/index.js +99 -82
- package/dist/checkout/index.js.map +1 -1
- package/dist/checkout/{index.d.cts → types.d.ts} +18 -40
- package/dist/checkout/types.d.ts.map +1 -0
- package/dist/chunk-6Z6JGK2C.cjs.map +1 -1
- package/dist/chunk-QB7VB5FZ.cjs +523 -0
- package/dist/chunk-QB7VB5FZ.cjs.map +1 -0
- package/dist/{chunk-JNOHB4OP.js → chunk-UTDAFIQP.js} +234 -94
- package/dist/chunk-UTDAFIQP.js.map +1 -0
- package/dist/hooks/use-cart-actions.d.ts +68 -0
- package/dist/hooks/use-cart-actions.d.ts.map +1 -0
- package/dist/hooks/use-cart-initialization.d.ts +60 -0
- package/dist/hooks/use-cart-initialization.d.ts.map +1 -0
- package/dist/hooks/use-cart-pricing.d.ts +41 -0
- package/dist/hooks/use-cart-pricing.d.ts.map +1 -0
- package/dist/hooks/use-checkout-persistence.d.ts +40 -0
- package/dist/hooks/use-checkout-persistence.d.ts.map +1 -0
- package/dist/hooks/use-debounce.d.ts +6 -0
- package/dist/hooks/use-debounce.d.ts.map +1 -0
- package/dist/hooks/use-format-price.d.ts +29 -0
- package/dist/hooks/use-format-price.d.ts.map +1 -0
- package/dist/hooks/use-latest.d.ts +8 -0
- package/dist/hooks/use-latest.d.ts.map +1 -0
- package/dist/hooks/use-modal-lifecycle.d.ts +11 -0
- package/dist/hooks/use-modal-lifecycle.d.ts.map +1 -0
- package/dist/hooks/use-order-readiness.d.ts +47 -0
- package/dist/hooks/use-order-readiness.d.ts.map +1 -0
- package/dist/hooks/use-pagination-prefetch.d.ts +26 -0
- package/dist/hooks/use-pagination-prefetch.d.ts.map +1 -0
- package/dist/{use-order-readiness-DZTIfRzw.d.ts → hooks/use-payment-flow.d.ts} +23 -67
- package/dist/hooks/use-payment-flow.d.ts.map +1 -0
- package/dist/hooks/use-stock.d.ts +32 -0
- package/dist/hooks/use-stock.d.ts.map +1 -0
- package/dist/index.cjs +215 -178
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +32 -456
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +193 -156
- package/dist/index.js.map +1 -1
- package/dist/persistence/apply-limits.d.ts +8 -0
- package/dist/persistence/apply-limits.d.ts.map +1 -0
- package/dist/persistence/create-persister.d.ts +10 -0
- package/dist/persistence/create-persister.d.ts.map +1 -0
- package/dist/persistence/serializer.d.ts +11 -0
- package/dist/persistence/serializer.d.ts.map +1 -0
- package/dist/persistence/use-persistence.d.ts +59 -0
- package/dist/persistence/use-persistence.d.ts.map +1 -0
- package/dist/persistence/use-storage-monitor.d.ts +11 -0
- package/dist/persistence/use-storage-monitor.d.ts.map +1 -0
- package/dist/provider.d.ts +89 -0
- package/dist/provider.d.ts.map +1 -0
- package/dist/queries/batch-query.d.ts +23 -0
- package/dist/queries/batch-query.d.ts.map +1 -0
- package/dist/queries/cache-helper.d.ts +16 -0
- package/dist/queries/cache-helper.d.ts.map +1 -0
- package/dist/queries/index.d.ts +3 -0
- package/dist/queries/index.d.ts.map +1 -0
- package/dist/query-action-registry.d.ts +19 -0
- package/dist/query-action-registry.d.ts.map +1 -0
- package/dist/rules.d.ts +130 -0
- package/dist/rules.d.ts.map +1 -0
- package/dist/server.cjs.map +1 -1
- package/dist/server.d.ts +10 -12
- package/dist/server.d.ts.map +1 -0
- package/dist/stores/cart-store.d.ts +51 -0
- package/dist/stores/cart-store.d.ts.map +1 -0
- package/dist/stores/items-filters-store.d.ts +30 -0
- package/dist/stores/items-filters-store.d.ts.map +1 -0
- package/dist/types.d.ts +48 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/web/use-image-with-fallback.d.ts +16 -0
- package/dist/web/use-image-with-fallback.d.ts.map +1 -0
- package/dist/web/use-mobile-detection.d.ts +28 -0
- package/dist/web/use-mobile-detection.d.ts.map +1 -0
- package/dist/web/use-mobile-optimized-intersection.d.ts +17 -0
- package/dist/web/use-mobile-optimized-intersection.d.ts.map +1 -0
- package/dist/web.cjs.map +1 -1
- package/dist/web.d.ts +4 -60
- package/dist/web.d.ts.map +1 -0
- package/dist/web.js.map +1 -1
- package/llms.txt +76 -54
- package/package.json +25 -14
- package/dist/batch-query-CTlvxSmL.d.cts +0 -165
- package/dist/batch-query-CTlvxSmL.d.ts +0 -165
- package/dist/chunk-F5DUFW57.cjs +0 -383
- package/dist/chunk-F5DUFW57.cjs.map +0 -1
- package/dist/chunk-JNOHB4OP.js.map +0 -1
- package/dist/index.d.cts +0 -456
- package/dist/server.d.cts +0 -44
- package/dist/use-order-readiness-DZTIfRzw.d.cts +0 -137
- package/dist/web.d.cts +0 -60
|
@@ -1,8 +1,7 @@
|
|
|
1
|
-
import
|
|
2
|
-
import { TTransactionSetup, TCardInfo, TPaymentValidation, TAccountQuery, TBillingUpdate } from
|
|
3
|
-
|
|
1
|
+
import type { Dispatch, SetStateAction } from "react";
|
|
2
|
+
import type { TTransactionSetup, TCardInfo, TPaymentValidation, TAccountQuery, TBillingUpdate } from "@simpleapps-com/augur-utils";
|
|
4
3
|
/** Site-specific payment action callbacks injected into usePaymentFlow. */
|
|
5
|
-
interface PaymentFlowCallbacks {
|
|
4
|
+
export interface PaymentFlowCallbacks {
|
|
6
5
|
/** Initialize a payment session. Returns transaction setup or undefined on failure. */
|
|
7
6
|
transactionSetup: (params: {
|
|
8
7
|
customerId: string;
|
|
@@ -36,7 +35,7 @@ interface PaymentFlowCallbacks {
|
|
|
36
35
|
};
|
|
37
36
|
}
|
|
38
37
|
/** Billing address shape accepted by the payment flow. */
|
|
39
|
-
interface PaymentBillingAddress {
|
|
38
|
+
export interface PaymentBillingAddress {
|
|
40
39
|
address1: string;
|
|
41
40
|
address2?: string;
|
|
42
41
|
city: string;
|
|
@@ -52,6 +51,22 @@ interface UsePaymentFlowParams {
|
|
|
52
51
|
/** Persist payment tokens to sessionStorage for cross-navigation recovery. */
|
|
53
52
|
persistPayment?: boolean;
|
|
54
53
|
}
|
|
54
|
+
/** sessionStorage key for persisted payment tokens. */
|
|
55
|
+
export declare const PAYMENT_STORAGE_KEY = "checkout:payment";
|
|
56
|
+
/** State and setters returned by usePaymentFlow. */
|
|
57
|
+
interface PaymentFlow {
|
|
58
|
+
isOpen: boolean;
|
|
59
|
+
setIsOpen: Dispatch<SetStateAction<boolean>>;
|
|
60
|
+
editCc: boolean;
|
|
61
|
+
setEditCc: Dispatch<SetStateAction<boolean>>;
|
|
62
|
+
unified: TTransactionSetup | null;
|
|
63
|
+
unifiedCc: TCardInfo | null;
|
|
64
|
+
unifiedResponse: boolean;
|
|
65
|
+
unifiedBilling: boolean;
|
|
66
|
+
unifiedPayment: TAccountQuery | null;
|
|
67
|
+
capturedBin: string | null;
|
|
68
|
+
handleBinCapture: (bin: string) => void;
|
|
69
|
+
}
|
|
55
70
|
/**
|
|
56
71
|
* Manages the full Element/Unified payment lifecycle:
|
|
57
72
|
* transactionSetup -> cardInfo -> validatePayment -> accountQuery -> billingUpdate
|
|
@@ -73,65 +88,6 @@ interface UsePaymentFlowParams {
|
|
|
73
88
|
* });
|
|
74
89
|
* ```
|
|
75
90
|
*/
|
|
76
|
-
declare function usePaymentFlow({ callbacks, customerId, billingAddress, paymentMethod, shippingAccepted, persistPayment, }: UsePaymentFlowParams):
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
editCc: boolean;
|
|
80
|
-
setEditCc: react.Dispatch<react.SetStateAction<boolean>>;
|
|
81
|
-
unified: TTransactionSetup | null;
|
|
82
|
-
unifiedCc: TCardInfo | null;
|
|
83
|
-
unifiedResponse: boolean;
|
|
84
|
-
unifiedBilling: boolean;
|
|
85
|
-
unifiedPayment: TAccountQuery | null;
|
|
86
|
-
capturedBin: string | null;
|
|
87
|
-
handleBinCapture: (bin: string) => void;
|
|
88
|
-
};
|
|
89
|
-
|
|
90
|
-
/** Parameters for order readiness validation. */
|
|
91
|
-
interface OrderReadinessParams {
|
|
92
|
-
cartHdrUid: string | number | undefined;
|
|
93
|
-
shippingAddress: unknown;
|
|
94
|
-
billingAddress: unknown;
|
|
95
|
-
shippingMethodSaved: boolean;
|
|
96
|
-
showBillingInfoSummary: boolean;
|
|
97
|
-
processingOrder: boolean;
|
|
98
|
-
paymentMethod: string;
|
|
99
|
-
unifiedPaymentAccountId: string | undefined;
|
|
100
|
-
unifiedBilling: boolean;
|
|
101
|
-
isFreeShipping: boolean;
|
|
102
|
-
carrierId: string;
|
|
103
|
-
shippingFee: number | undefined;
|
|
104
|
-
isEditShippingInfo: boolean;
|
|
105
|
-
isEditShippingMethods: boolean;
|
|
106
|
-
isEditBillingInfo: boolean;
|
|
107
|
-
editCc: boolean;
|
|
108
|
-
/**
|
|
109
|
-
* Site-provided function to check if the order is ready.
|
|
110
|
-
*
|
|
111
|
-
* Return `true` or `false` to override the default gates. Return
|
|
112
|
-
* `undefined` to defer to the default logic (useful when the override
|
|
113
|
-
* only applies to specific order flows — e.g. sample-only or pickup).
|
|
114
|
-
*/
|
|
115
|
-
customReadinessCheck?: (params: OrderReadinessParams) => boolean | undefined;
|
|
116
|
-
}
|
|
117
|
-
/**
|
|
118
|
-
* Pure function that determines if an order is ready to submit.
|
|
119
|
-
*
|
|
120
|
-
* Checks all gates: cart exists, addresses present, shipping method saved,
|
|
121
|
-
* billing shown, payment complete (for credit card), shipping fee present
|
|
122
|
-
* (for non-free, non-pickup orders), and no sections being edited.
|
|
123
|
-
*/
|
|
124
|
-
declare function determineOrderReadiness(params: OrderReadinessParams): boolean;
|
|
125
|
-
/**
|
|
126
|
-
* Debounced order readiness hook.
|
|
127
|
-
*
|
|
128
|
-
* Recomputes readiness 300ms after any dependency changes to avoid
|
|
129
|
-
* excessive re-renders during rapid state transitions (e.g., typing
|
|
130
|
-
* in address fields).
|
|
131
|
-
*/
|
|
132
|
-
declare function useOrderReadiness(params: OrderReadinessParams): {
|
|
133
|
-
enableProcessOrderBtn: boolean;
|
|
134
|
-
processingValidation: boolean;
|
|
135
|
-
};
|
|
136
|
-
|
|
137
|
-
export { type OrderReadinessParams as O, type PaymentBillingAddress as P, type PaymentFlowCallbacks as a, usePaymentFlow as b, determineOrderReadiness as d, useOrderReadiness as u };
|
|
91
|
+
export declare function usePaymentFlow({ callbacks, customerId, billingAddress, paymentMethod, shippingAccepted, persistPayment, }: UsePaymentFlowParams): PaymentFlow;
|
|
92
|
+
export {};
|
|
93
|
+
//# sourceMappingURL=use-payment-flow.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"use-payment-flow.d.ts","sourceRoot":"","sources":["../../src/hooks/use-payment-flow.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { ResolvedStock, TStock } from "@simpleapps-com/augur-utils";
|
|
2
|
+
export interface UseStockOptions {
|
|
3
|
+
enabled?: boolean;
|
|
4
|
+
/** Override the default queryFn (e.g. with a custom server action). */
|
|
5
|
+
queryFn?: () => Promise<TStock>;
|
|
6
|
+
/** Company key to extract stock for a specific company. */
|
|
7
|
+
companyKey?: string;
|
|
8
|
+
/** Whether to round the quantity. */
|
|
9
|
+
round?: boolean;
|
|
10
|
+
/** Threshold below which stock is considered "low". */
|
|
11
|
+
lowStockThreshold?: number;
|
|
12
|
+
/** Whether to include the quantity in the resolved output. */
|
|
13
|
+
showQuantity?: boolean;
|
|
14
|
+
}
|
|
15
|
+
/** Raw stock, its resolved form, and query state returned by useStock. */
|
|
16
|
+
interface StockResult {
|
|
17
|
+
stock: TStock | null;
|
|
18
|
+
resolved: ResolvedStock | null;
|
|
19
|
+
loading: boolean;
|
|
20
|
+
error: Error | null;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Fetches full TStock data and resolves it into a normalized stock object.
|
|
24
|
+
*
|
|
25
|
+
* Uses the proxy from AugurHooksProvider context. Works with:
|
|
26
|
+
* - Direct SDK (api prop on provider)
|
|
27
|
+
* - Server actions (auto-detected via queryAction registration)
|
|
28
|
+
* - Custom queryFn override
|
|
29
|
+
*/
|
|
30
|
+
export declare function useStock(invMastUid: number | string, options?: UseStockOptions): StockResult;
|
|
31
|
+
export {};
|
|
32
|
+
//# sourceMappingURL=use-stock.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"use-stock.d.ts","sourceRoot":"","sources":["../../src/hooks/use-stock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAKzE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,0EAA0E;AAC1E,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,WAAW,CAqChG"}
|