@simpleapps-com/augur-server 2.3.1 → 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.
Files changed (140) hide show
  1. package/EXPORTS.md +29 -72
  2. package/README.md +29 -198
  3. package/dist/actions/agr-info.d.ts +43 -0
  4. package/dist/actions/agr-info.d.ts.map +1 -0
  5. package/dist/actions/agr-site.d.ts +37 -0
  6. package/dist/actions/agr-site.d.ts.map +1 -0
  7. package/dist/actions/agr-work.d.ts +29 -0
  8. package/dist/actions/agr-work.d.ts.map +1 -0
  9. package/dist/actions/avalara.d.ts +38 -0
  10. package/dist/actions/avalara.d.ts.map +1 -0
  11. package/dist/actions/basecamp2.d.ts +47 -0
  12. package/dist/actions/basecamp2.d.ts.map +1 -0
  13. package/dist/actions/brand-folder.d.ts +38 -0
  14. package/dist/actions/brand-folder.d.ts.map +1 -0
  15. package/dist/actions/commerce.d.ts +58 -0
  16. package/dist/actions/commerce.d.ts.map +1 -0
  17. package/dist/actions/customers.d.ts +44 -0
  18. package/dist/actions/customers.d.ts.map +1 -0
  19. package/dist/actions/favorites.d.ts +20 -0
  20. package/dist/actions/favorites.d.ts.map +1 -0
  21. package/dist/actions/gregorovich.d.ts +34 -0
  22. package/dist/actions/gregorovich.d.ts.map +1 -0
  23. package/dist/actions/items.d.ts +80 -0
  24. package/dist/actions/items.d.ts.map +1 -0
  25. package/dist/actions/joomla.d.ts +59 -0
  26. package/dist/actions/joomla.d.ts.map +1 -0
  27. package/dist/actions/legacy.d.ts +45 -0
  28. package/dist/actions/legacy.d.ts.map +1 -0
  29. package/dist/actions/logistics.d.ts +40 -0
  30. package/dist/actions/logistics.d.ts.map +1 -0
  31. package/dist/actions/orders.d.ts +36 -0
  32. package/dist/actions/orders.d.ts.map +1 -0
  33. package/dist/actions/p21-apis.d.ts +33 -0
  34. package/dist/actions/p21-apis.d.ts.map +1 -0
  35. package/dist/actions/p21-core.d.ts +46 -0
  36. package/dist/actions/p21-core.d.ts.map +1 -0
  37. package/dist/actions/p21-pim.d.ts +36 -0
  38. package/dist/actions/p21-pim.d.ts.map +1 -0
  39. package/dist/actions/p21-sism.d.ts +37 -0
  40. package/dist/actions/p21-sism.d.ts.map +1 -0
  41. package/dist/actions/payments.d.ts +39 -0
  42. package/dist/actions/payments.d.ts.map +1 -0
  43. package/dist/actions/pricing.d.ts +45 -0
  44. package/dist/actions/pricing.d.ts.map +1 -0
  45. package/dist/actions/search.d.ts +61 -0
  46. package/dist/actions/search.d.ts.map +1 -0
  47. package/dist/actions/shipping.d.ts +56 -0
  48. package/dist/actions/shipping.d.ts.map +1 -0
  49. package/dist/actions/site.d.ts +141 -0
  50. package/dist/actions/site.d.ts.map +1 -0
  51. package/dist/actions/smarty-streets.d.ts +45 -0
  52. package/dist/actions/smarty-streets.d.ts.map +1 -0
  53. package/dist/actions/vmi.d.ts +44 -0
  54. package/dist/actions/vmi.d.ts.map +1 -0
  55. package/dist/actions/wishlists.d.ts +28 -0
  56. package/dist/actions/wishlists.d.ts.map +1 -0
  57. package/dist/api-handler.d.ts +25 -0
  58. package/dist/api-handler.d.ts.map +1 -0
  59. package/dist/api.d.ts +2 -26
  60. package/dist/api.d.ts.map +1 -0
  61. package/dist/api.js +19 -14
  62. package/dist/api.js.map +1 -1
  63. package/dist/auth.d.ts +10 -12
  64. package/dist/auth.d.ts.map +1 -0
  65. package/dist/auth.js +2 -2
  66. package/dist/cache/redis-client.d.ts +16 -0
  67. package/dist/cache/redis-client.d.ts.map +1 -0
  68. package/dist/cache/with-cache.d.ts +18 -0
  69. package/dist/cache/with-cache.d.ts.map +1 -0
  70. package/dist/chunk-FWO6Q43T.js +162 -0
  71. package/dist/chunk-FWO6Q43T.js.map +1 -0
  72. package/dist/{chunk-HPQQYROJ.js → chunk-NTUPTNOI.js} +40 -7
  73. package/dist/chunk-NTUPTNOI.js.map +1 -0
  74. package/dist/{chunk-WOHZDFJF.js → chunk-PFYEMJTQ.js} +212 -642
  75. package/dist/chunk-PFYEMJTQ.js.map +1 -0
  76. package/dist/{chunk-KHFEDL47.js → chunk-SXXWBSTX.js} +18 -12
  77. package/dist/chunk-SXXWBSTX.js.map +1 -0
  78. package/dist/chunk-TVH5EONP.js +178 -0
  79. package/dist/chunk-TVH5EONP.js.map +1 -0
  80. package/dist/{chunk-TQP67TGL.js → chunk-U2BKHRJC.js} +13 -15
  81. package/dist/chunk-U2BKHRJC.js.map +1 -0
  82. package/dist/environment.d.ts +10 -0
  83. package/dist/environment.d.ts.map +1 -0
  84. package/dist/hooks.d.ts +8 -10
  85. package/dist/hooks.d.ts.map +1 -0
  86. package/dist/hooks.js +3 -3
  87. package/dist/hooks.js.map +1 -1
  88. package/dist/index.d.ts +16 -125
  89. package/dist/index.d.ts.map +1 -0
  90. package/dist/index.js +12 -8
  91. package/dist/index.js.map +1 -1
  92. package/dist/pagination.d.ts +32 -0
  93. package/dist/pagination.d.ts.map +1 -0
  94. package/dist/query-action.d.ts +156 -17
  95. package/dist/query-action.d.ts.map +1 -0
  96. package/dist/query-action.js +3 -3
  97. package/dist/query-options-helper.d.ts +33 -0
  98. package/dist/query-options-helper.d.ts.map +1 -0
  99. package/dist/query.js +1 -2
  100. package/dist/recaptcha.d.ts +6 -0
  101. package/dist/recaptcha.d.ts.map +1 -0
  102. package/dist/rules.d.ts +221 -0
  103. package/dist/rules.d.ts.map +1 -0
  104. package/dist/scoped-client-key.d.ts +9 -0
  105. package/dist/scoped-client-key.d.ts.map +1 -0
  106. package/dist/sdk-call.d.ts +66 -0
  107. package/dist/sdk-call.d.ts.map +1 -0
  108. package/dist/sdk-client-store.d.ts +250 -0
  109. package/dist/sdk-client-store.d.ts.map +1 -0
  110. package/dist/server-actions.d.ts +2 -0
  111. package/dist/server-actions.d.ts.map +1 -0
  112. package/dist/server-query-client.d.ts +19 -0
  113. package/dist/server-query-client.d.ts.map +1 -0
  114. package/dist/{server-site-registry-CdBfczOj.d.ts → server-site-registry.d.ts} +7 -9
  115. package/dist/server-site-registry.d.ts.map +1 -0
  116. package/dist/{site.d.ts → server-site.d.ts} +11 -16
  117. package/dist/server-site.d.ts.map +1 -0
  118. package/dist/site-actions-store.d.ts +27 -0
  119. package/dist/site-actions-store.d.ts.map +1 -0
  120. package/dist/site.js +10 -10
  121. package/dist/site.js.map +1 -1
  122. package/dist/testing.d.ts +9 -12
  123. package/dist/testing.d.ts.map +1 -0
  124. package/dist/testing.js +7 -27
  125. package/dist/testing.js.map +1 -1
  126. package/dist/utils/batch-fetch.d.ts +7 -0
  127. package/dist/utils/batch-fetch.d.ts.map +1 -0
  128. package/llms.txt +71 -50
  129. package/package.json +34 -20
  130. package/dist/actions.d.ts +0 -2
  131. package/dist/chunk-DGUM43GV.js +0 -11
  132. package/dist/chunk-DGUM43GV.js.map +0 -1
  133. package/dist/chunk-HPQQYROJ.js.map +0 -1
  134. package/dist/chunk-KHFEDL47.js.map +0 -1
  135. package/dist/chunk-TQP67TGL.js.map +0 -1
  136. package/dist/chunk-WOHZDFJF.js.map +0 -1
  137. package/dist/chunk-ZUJZDRTP.js +0 -136
  138. package/dist/chunk-ZUJZDRTP.js.map +0 -1
  139. package/dist/query.d.ts +0 -31
  140. package/dist/site-BjSFqufX.d.ts +0 -469
@@ -1,136 +0,0 @@
1
- import {
2
- getAuthSecret,
3
- getOrCreateScopedClient,
4
- getScopedCacheWrapper,
5
- getSdkCallWrapper,
6
- getSdkClientOrNull
7
- } from "./chunk-HPQQYROJ.js";
8
-
9
- // src/query-action.ts
10
- import { isReadMethod, stripEdgeCacheForNoCachePaths } from "@simpleapps-com/augur-core";
11
- var SECURE_COOKIE = "__Secure-authjs.session-token";
12
- var PLAIN_COOKIE = "authjs.session-token";
13
- var _decode;
14
- var _cookies;
15
- async function ensureImports() {
16
- if (_decode === void 0) {
17
- try {
18
- const mod = await import("next-auth/jwt");
19
- _decode = mod.decode;
20
- } catch {
21
- _decode = null;
22
- }
23
- }
24
- if (_cookies === void 0) {
25
- try {
26
- const mod = await import("next/headers");
27
- _cookies = mod.cookies;
28
- } catch {
29
- _cookies = null;
30
- }
31
- }
32
- return !!_decode && !!_cookies;
33
- }
34
- async function decodeSessionJwt(secret) {
35
- const cookieStore = await _cookies();
36
- const secureCookie = cookieStore.get(SECURE_COOKIE);
37
- const plainCookie = secureCookie ? void 0 : cookieStore.get(PLAIN_COOKIE);
38
- const cookie = secureCookie ?? plainCookie;
39
- if (!cookie?.value) return null;
40
- const salt = secureCookie ? SECURE_COOKIE : PLAIN_COOKIE;
41
- return _decode({ token: cookie.value, secret, salt });
42
- }
43
- async function getSessionCredentials() {
44
- const secret = getAuthSecret();
45
- if (!secret) return null;
46
- if (!await ensureImports()) return null;
47
- try {
48
- const decoded = await decodeSessionJwt(secret);
49
- if (!decoded) return null;
50
- const targetSiteId = decoded["targetSiteId"];
51
- const token = decoded["token"];
52
- if (targetSiteId && token) {
53
- return { siteId: targetSiteId, token };
54
- }
55
- } catch {
56
- }
57
- return null;
58
- }
59
- async function resolveClientAndPrefix() {
60
- const globalClient = getSdkClientOrNull();
61
- const creds = await getSessionCredentials();
62
- if (creds) {
63
- const scoped = getOrCreateScopedClient(creds.siteId, creds.token);
64
- if (scoped) {
65
- return { client: scoped, cachePrefix: `${creds.siteId}:` };
66
- }
67
- }
68
- return { client: globalClient, cachePrefix: null };
69
- }
70
- function unwrapBaseResponse(raw) {
71
- if (raw != null && typeof raw === "object" && "data" in raw && "status" in raw && "message" in raw) {
72
- return raw.data;
73
- }
74
- return raw;
75
- }
76
- function resolveMethod(client, methodPath) {
77
- const segments = methodPath.split(".");
78
- let current = client;
79
- for (const segment of segments) {
80
- if (current == null || typeof current !== "object" && typeof current !== "function") {
81
- throw new Error(
82
- `Cannot resolve "${methodPath}": "${segment}" is not accessible on ${typeof current}`
83
- );
84
- }
85
- current = current[segment];
86
- }
87
- if (typeof current !== "function") {
88
- throw new Error(`"${methodPath}" does not resolve to a function (got ${typeof current})`);
89
- }
90
- return current;
91
- }
92
- async function queryAction(methodPath, ...args) {
93
- const { client, cachePrefix } = await resolveClientAndPrefix();
94
- if (!client) {
95
- throw new Error(
96
- "SDK client not initialized. Call createServerSite() or set AUGUR_SITE_ID + AUGUR_JWT env vars."
97
- );
98
- }
99
- const resolvedMethod = resolveMethod(client, methodPath);
100
- const leafName = methodPath.split(".").pop();
101
- const safeArgs = stripEdgeCacheForNoCachePaths(methodPath, args);
102
- if (cachePrefix !== null) {
103
- const scopedWrapper = getScopedCacheWrapper();
104
- if (scopedWrapper && isReadMethod(leafName)) {
105
- const result3 = await scopedWrapper(
106
- cachePrefix,
107
- methodPath,
108
- () => resolvedMethod(...safeArgs),
109
- ...safeArgs
110
- );
111
- return unwrapBaseResponse(result3);
112
- }
113
- const result2 = await resolvedMethod(...safeArgs);
114
- return unwrapBaseResponse(result2);
115
- }
116
- const wrapper = getSdkCallWrapper();
117
- if (wrapper && isReadMethod(leafName)) {
118
- const result2 = await wrapper(methodPath, () => resolvedMethod(...safeArgs), ...safeArgs);
119
- return unwrapBaseResponse(result2);
120
- }
121
- const result = await resolvedMethod(...safeArgs);
122
- return unwrapBaseResponse(result);
123
- }
124
- function resetSessionImports() {
125
- _decode = void 0;
126
- _cookies = void 0;
127
- }
128
-
129
- export {
130
- getSessionCredentials,
131
- unwrapBaseResponse,
132
- resolveMethod,
133
- queryAction,
134
- resetSessionImports
135
- };
136
- //# sourceMappingURL=chunk-ZUJZDRTP.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/query-action.ts"],"sourcesContent":["// \"use server\" banner is injected by tsup at build time.\n// Isolated server action for the proxy pattern.\n// This file MUST NOT import from server-actions.ts, server-site-registry.ts,\n// cache/, or any factory. It imports only from lightweight stores with zero\n// deps, plus augur-core (external in tsup — not bundled into chunks).\n// Dynamic imports of next/headers and next-auth/jwt are used for session\n// credential resolution (both are external in tsup).\n\nimport {\n getSdkClientOrNull,\n getSdkCallWrapper,\n getAuthSecret,\n getOrCreateScopedClient,\n getScopedCacheWrapper,\n} from \"./sdk-client-store\";\nimport { isReadMethod, stripEdgeCacheForNoCachePaths } from \"@simpleapps-com/augur-core\";\n\n/** Auth.js v5 session cookie names (HTTPS secure prefix + HTTP fallback). */\nconst SECURE_COOKIE = \"__Secure-authjs.session-token\";\nconst PLAIN_COOKIE = \"authjs.session-token\";\n\n/** Simplified function types for lazy-loaded external deps. */\ntype DecodeFn = (params: {\n token?: string;\n secret: string | string[];\n salt: string;\n}) => Promise<Record<string, unknown> | null>;\ntype CookiesFn = () => Promise<{ get: (name: string) => { value: string } | undefined }>;\n\n/** Cached dynamic imports for next-auth/jwt decode and next/headers cookies. */\nlet _decode: DecodeFn | null | undefined;\nlet _cookies: CookiesFn | null | undefined;\n\n/** Lazy-load decode and cookies functions from external deps. Cached after first call. */\nasync function ensureImports(): Promise<boolean> {\n if (_decode === undefined) {\n try {\n const mod = await import(\"next-auth/jwt\");\n _decode = mod.decode as unknown as DecodeFn;\n /* v8 ignore next 3 -- dynamic import only fails when next-auth is not installed */\n } catch {\n _decode = null;\n }\n }\n if (_cookies === undefined) {\n try {\n const mod = await import(\"next/headers\");\n _cookies = mod.cookies as unknown as CookiesFn;\n /* v8 ignore next 3 -- dynamic import only fails when next is not installed */\n } catch {\n _cookies = null;\n }\n }\n /* v8 ignore next -- _decode/_cookies null branch only when imports fail (untestable with vi.mock) */\n return !!_decode && !!_cookies;\n}\n\n/** Read and decode the Auth.js session JWT from request cookies. */\nasync function decodeSessionJwt(secret: string): Promise<Record<string, unknown> | null> {\n const cookieStore = await _cookies!();\n const secureCookie = cookieStore.get(SECURE_COOKIE);\n const plainCookie = secureCookie ? undefined : cookieStore.get(PLAIN_COOKIE);\n const cookie = secureCookie ?? plainCookie;\n if (!cookie?.value) return null;\n\n const salt = secureCookie ? SECURE_COOKIE : PLAIN_COOKIE;\n return _decode!({ token: cookie.value, secret, salt });\n}\n\n/**\n * Resolve session credentials from the Auth.js JWT cookie.\n * Returns the targetSiteId and token if present, or null.\n * Falls back to null on any error (no cookie, no secret, not in request context).\n */\nasync function getSessionCredentials(): Promise<{ siteId: string; token: string } | null> {\n const secret = getAuthSecret();\n if (!secret) return null;\n /* v8 ignore next -- ensureImports returns false only when dynamic imports fail (untestable with vi.mock) */\n if (!(await ensureImports())) return null;\n\n try {\n const decoded = await decodeSessionJwt(secret);\n if (!decoded) return null;\n\n const targetSiteId = decoded[\"targetSiteId\"] as string | undefined;\n const token = decoded[\"token\"] as string | undefined;\n if (targetSiteId && token) {\n return { siteId: targetSiteId, token };\n }\n } catch {\n // Not in a request context (build time, tests), or decode failed\n }\n\n return null;\n}\n\n/**\n * Resolve the SDK client and cache prefix for this request.\n * If the session has targetSiteId + token, returns a scoped client.\n * Otherwise returns the global client.\n */\nasync function resolveClientAndPrefix(): Promise<{\n client: unknown;\n cachePrefix: string | null;\n}> {\n const globalClient = getSdkClientOrNull();\n\n const creds = await getSessionCredentials();\n if (creds) {\n const scoped = getOrCreateScopedClient(creds.siteId, creds.token);\n if (scoped) {\n return { client: scoped, cachePrefix: `${creds.siteId}:` };\n }\n }\n\n return { client: globalClient, cachePrefix: null };\n}\n\n/**\n * Unwrap SDK BaseResponse if the result matches the standard shape.\n * The SDK wraps all responses in `{ data: T, status: number, message: string }`.\n * SiteActions previously unwrapped this; queryAction now does it automatically\n * so consumers receive `T` directly.\n */\nfunction unwrapBaseResponse(raw: unknown): unknown {\n if (\n raw != null &&\n typeof raw === \"object\" &&\n \"data\" in raw &&\n \"status\" in raw &&\n \"message\" in raw\n ) {\n return (raw as { data: unknown }).data;\n }\n return raw;\n}\n\n/** Resolve a dot-separated method path on an object, returning the leaf function. */\nfunction resolveMethod(client: unknown, methodPath: string): (...a: unknown[]) => Promise<unknown> {\n const segments = methodPath.split(\".\");\n\n let current: unknown = client;\n for (const segment of segments) {\n if (current == null || (typeof current !== \"object\" && typeof current !== \"function\")) {\n throw new Error(\n `Cannot resolve \"${methodPath}\": \"${segment}\" is not accessible on ${typeof current}`,\n );\n }\n current = (current as Record<string, unknown>)[segment];\n }\n\n if (typeof current !== \"function\") {\n throw new Error(`\"${methodPath}\" does not resolve to a function (got ${typeof current})`);\n }\n\n return current as (...a: unknown[]) => Promise<unknown>;\n}\n\n/**\n * Generic server action that routes any SDK method call through the raw\n * SDK client with optional Redis caching. Used internally by\n * `createServerQueryProxy()` to bridge client-side React Query hooks\n * to server-side API calls.\n *\n * For read methods (get, list, lookup, search, suggest), the call is\n * wrapped in the registered cache wrapper (Redis) if one was registered\n * by createServerSite(). Write methods bypass caching.\n *\n * When the request has an active session with targetSiteId + token\n * (from cross-site auth), the call uses a scoped SDK client with those\n * credentials. Redis caching uses targetSiteId as the cache prefix so\n * users managing the same site share cached data.\n *\n * SDK responses wrapped in BaseResponse are automatically unwrapped --\n * consumers receive `T` instead of `{ data: T, status, message }`.\n *\n * @param methodPath Dot-separated SDK method path (e.g. \"items.invMast.doc.get\")\n * @param args Arguments to pass to the resolved method\n * @returns The unwrapped result from the SDK method (possibly from Redis cache)\n */\nexport async function queryAction(methodPath: string, ...args: unknown[]): Promise<unknown> {\n const { client, cachePrefix } = await resolveClientAndPrefix();\n if (!client) {\n throw new Error(\n \"SDK client not initialized. Call createServerSite() or set AUGUR_SITE_ID + AUGUR_JWT env vars.\",\n );\n }\n\n const resolvedMethod = resolveMethod(client, methodPath);\n const leafName = methodPath.split(\".\").pop()!;\n // Defense in depth: strip `edgeCache` from no-cache paths before the SDK\n // sees it. The augur-api SDK transforms `edgeCache` into a Cloudflare\n // `cacheSiteId{N}` query param; removing it here guarantees no CDN edge\n // caching of identity-bound responses even if a caller explicitly passed\n // one. Also keeps cache keys consistent with what is actually sent.\n const safeArgs = stripEdgeCacheForNoCachePaths(methodPath, args);\n\n // Scoped client — use scoped cache wrapper with targetSiteId prefix\n if (cachePrefix !== null) {\n const scopedWrapper = getScopedCacheWrapper();\n if (scopedWrapper && isReadMethod(leafName)) {\n const result = await scopedWrapper(\n cachePrefix,\n methodPath,\n () => resolvedMethod(...safeArgs),\n ...safeArgs,\n );\n return unwrapBaseResponse(result);\n }\n const result = await resolvedMethod(...safeArgs);\n return unwrapBaseResponse(result);\n }\n\n // Global client — use standard cache wrapper\n const wrapper = getSdkCallWrapper();\n if (wrapper && isReadMethod(leafName)) {\n const result = await wrapper(methodPath, () => resolvedMethod(...safeArgs), ...safeArgs);\n return unwrapBaseResponse(result);\n }\n\n const result = await resolvedMethod(...safeArgs);\n return unwrapBaseResponse(result);\n}\n\n/** Reset lazy-loaded imports. Used in tests only. @internal */\nexport function resetSessionImports(): void {\n _decode = undefined;\n _cookies = undefined;\n}\n\nexport { unwrapBaseResponse, getSessionCredentials, resolveMethod };\n"],"mappings":"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","names":["result"]}
package/dist/query.d.ts DELETED
@@ -1,31 +0,0 @@
1
- import { UseQueryOptions, UseSuspenseQueryOptions } from '@tanstack/react-query';
2
-
3
- interface QueryOptionsConfig<TParams, TData> {
4
- /** Base query key (e.g., "customer-orders") */
5
- baseKey: string;
6
- /** Parameters object */
7
- params: TParams;
8
- /** Function that returns the data */
9
- queryFn: (params: TParams) => Promise<TData>;
10
- /** Function to determine if query should be enabled */
11
- enabledFn?: (params: TParams) => boolean;
12
- /** Custom stale time in milliseconds (default: SEMI_STATIC) */
13
- staleTime?: number;
14
- /** Custom garbage collection time in milliseconds (default: SEMI_STATIC) */
15
- gcTime?: number;
16
- /** Key to exclude from query key generation */
17
- excludeFromKey?: keyof TParams;
18
- }
19
- /**
20
- * Creates useQuery options with consistent key generation.
21
- * Filters out undefined/null/empty params from the query key.
22
- */
23
- declare const createQueryOptions: <TParams extends Record<string, unknown>, TData>({ baseKey, params, queryFn, enabledFn, staleTime, gcTime, excludeFromKey, }: QueryOptionsConfig<TParams, TData>) => UseQueryOptions<TData>;
24
- /**
25
- * Creates useSuspenseQuery options with consistent key generation.
26
- * Same as createQueryOptions but without enabledFn (suspense queries
27
- * cannot be disabled).
28
- */
29
- declare const createSuspenseQueryOptions: <TParams extends Record<string, unknown>, TData>({ baseKey, params, queryFn, staleTime, gcTime, excludeFromKey, }: Omit<QueryOptionsConfig<TParams, TData>, "enabledFn">) => UseSuspenseQueryOptions<TData>;
30
-
31
- export { type QueryOptionsConfig, createQueryOptions, createSuspenseQueryOptions };
@@ -1,469 +0,0 @@
1
- import { ListResult, EdgeCacheValue } from '@simpleapps-com/augur-core';
2
- import { TPriceData, TTaxItem, TTax, TCategory, TCategoryItemsResult, TItemsFilters, TProductItem, TAttribute, TInvMast, TInvMastDoc, TStock, TItemAccessory, TCartLookUp, TCartLine, TRelatedProduct, TCheckoutResult, TSearchSuggestionsResponse, TShippingMethod, TJoomlaContent, TMenu, MenuItem, TPasswordVerification, TWebDesc, CustomerDocument, TSmartyStreets, TTransactionSetup, TAccountQuery, TSurcharge, TCardInfo, TBillingUpdate, TPaymentValidation } from '@simpleapps-com/augur-utils';
3
-
4
- /**
5
- * Standardized paginated response shape.
6
- * Works with any factory method — compose with `paginateOffset()`.
7
- */
8
- interface PaginatedResult<T> {
9
- data: T[];
10
- total: number;
11
- nextCursor?: number;
12
- hasMore: boolean;
13
- }
14
- /**
15
- * Wraps a list of items with offset-based pagination metadata.
16
- *
17
- * Use this to standardize pagination responses from any factory method.
18
- * Compatible with React Query's infinite query pattern (`getNextPageParam`).
19
- *
20
- * @param items - The items returned from the current page
21
- * @param pageParam - The current page number (0-based)
22
- * @param limit - The page size
23
- * @param total - Optional total count of items (from API response)
24
- *
25
- * @example
26
- * ```ts
27
- * const result = await actions.items.getCategoryItems(uid, {
28
- * ...filters, offset: page * 24, limit: 24,
29
- * });
30
- * return paginateOffset(result.items, page, 24, result.total);
31
- * // { data: [...], total: 150, nextCursor: 1, hasMore: true }
32
- * ```
33
- */
34
- declare function paginateOffset<T>(items: T[], pageParam: number, limit: number, total?: number): PaginatedResult<T>;
35
-
36
- interface PricingActions {
37
- getItemPrice: (itemId: string, customerId?: string | number, quantity?: number) => Promise<TPriceData>;
38
- batchGetItemPrices: (itemIds: string[], customerId?: string | number, quantity?: number) => Promise<Record<string, TPriceData>>;
39
- getTaxEstimate: (customerId?: string | number, postalCode?: string, items?: TTaxItem[]) => Promise<TTax>;
40
- }
41
-
42
- /** Typed options for getItemCategory. */
43
- interface GetItemCategoryOptions {
44
- childrenFilter?: string;
45
- childrenLimit?: number;
46
- childrenOffset?: number;
47
- classId5List?: string;
48
- filters?: Record<string, string>;
49
- orderBy?: string;
50
- path?: string;
51
- productCollection?: string;
52
- rootItemCategoryId?: string;
53
- }
54
- interface ItemActions {
55
- itemCategoryLookup: (path: string) => Promise<unknown>;
56
- getItemCategory: (uid: number, options?: GetItemCategoryOptions) => Promise<TCategory>;
57
- getCategoryItems: {
58
- (uid: number, filters: Record<string, unknown>): Promise<TCategoryItemsResult>;
59
- (uid: number, itemsFilters: TItemsFilters): Promise<TCategoryItemsResult>;
60
- };
61
- getCategoryItemsInfinite: (uid: number, itemsFilters?: TItemsFilters, pageParam?: number) => Promise<PaginatedResult<TProductItem>>;
62
- getItemAttributes: (categoryUid: number) => Promise<{
63
- attributes: TAttribute[];
64
- }>;
65
- getInvMast: (uid: number) => Promise<TInvMast>;
66
- getInvMastDoc: {
67
- (params: {
68
- invMastUid?: number;
69
- itemId?: string;
70
- includePricing?: "Y" | "N";
71
- }): Promise<TInvMastDoc>;
72
- (invMastUid: number, itemId?: string, includePricing?: "Y" | "N"): Promise<TInvMastDoc>;
73
- };
74
- getStock: (invMastUid: number) => Promise<TStock>;
75
- getStockCompanySummary: (invMastUid: number) => Promise<Record<string, number>>;
76
- getItemFaqs: (invMastUid: number) => Promise<ListResult>;
77
- getItemSubstitutes: (invMastUid: number) => Promise<ListResult>;
78
- getItemAccessories: (invMastUid: number) => Promise<ListResult<TItemAccessory>>;
79
- getSimilarItems: (invMastUid: number) => Promise<ListResult>;
80
- batchGetInvMastDocs: (params: {
81
- invMastUid?: number;
82
- itemId?: string;
83
- }[]) => Promise<Record<string, TInvMastDoc>>;
84
- batchGetStockData: (invMastUids: number[]) => Promise<Record<number, TStock>>;
85
- }
86
-
87
- interface CommerceActions {
88
- cartHdrLookup: (params: {
89
- userId?: string | number;
90
- cartToken?: string;
91
- contactId?: string | number;
92
- customerId?: string | number;
93
- }) => Promise<TCartLookUp>;
94
- getCartLines: (cartHdrUid: number) => Promise<ListResult<TCartLine>>;
95
- addToCart: (cartHdrUid: number, items: {
96
- itemId?: string;
97
- invMastUid?: number;
98
- quantity: number;
99
- unitOfMeasure: string;
100
- }[]) => Promise<unknown>;
101
- updateCartLines: (cartHdrUid: number, lines: {
102
- lineNo: number;
103
- quantity: number;
104
- unitOfMeasure: string;
105
- }[]) => Promise<unknown>;
106
- deleteCartItems: (cartHdrUid: number) => Promise<void>;
107
- getCartAlsoBought: (cartHdrUid: number) => Promise<ListResult<TRelatedProduct>>;
108
- checkoutOrder: (cartHdrUid: number, data: Record<string, unknown>) => Promise<TCheckoutResult>;
109
- }
110
-
111
- /** Paginated response for infinite scroll. */
112
- interface SearchPage {
113
- data: TProductItem[];
114
- total: number;
115
- nextCursor?: number;
116
- }
117
- interface SearchActions {
118
- getSearchAttributes: (q: string) => Promise<{
119
- attributes: TAttribute[];
120
- }>;
121
- getSearchSuggestions: (q: string, limit?: number, offset?: number) => Promise<TSearchSuggestionsResponse>;
122
- itemSearch: (filters: {
123
- q: string;
124
- limit: number;
125
- offset: number;
126
- sortBy?: string;
127
- filters?: [string, string][];
128
- }, itemCategoryUid?: number | string) => Promise<{
129
- items: TProductItem[];
130
- totalResults: number;
131
- }>;
132
- itemSearchInfinite: (filters: {
133
- q: string;
134
- limit: number;
135
- sortBy?: string;
136
- filters?: [string, string][];
137
- }, itemCategoryUid?: number | string, pageParam?: number) => Promise<SearchPage>;
138
- }
139
-
140
- interface OrderActions {
141
- getOrderDoc: (orderNo: string, postalCode: string) => Promise<unknown>;
142
- }
143
-
144
- interface ShippingAddress {
145
- address1: string;
146
- city: string;
147
- state: string;
148
- postalCode: string;
149
- country?: string;
150
- }
151
- interface ShippingActions {
152
- getShippingRates: (toAddress: ShippingAddress, weight: number, serviceCodes?: string[]) => Promise<ListResult<TShippingMethod>>;
153
- }
154
-
155
- interface NormalizedUserProfile {
156
- id: string;
157
- name: string;
158
- email: string;
159
- customerId: string;
160
- permissions: string[];
161
- }
162
- interface JoomlaActions {
163
- getJoomlaContent: {
164
- (articleId: number): Promise<TJoomlaContent>;
165
- (articleId: number | string, options: {
166
- alias: string;
167
- catId?: number;
168
- }): Promise<TJoomlaContent>;
169
- };
170
- getJoomlaContentList: (params?: Record<string, unknown>) => Promise<ListResult<TJoomlaContent>>;
171
- getJoomlaMenu: {
172
- (params?: Record<string, unknown>): Promise<ListResult<TMenu>>;
173
- (parentId: number, menuType: string): Promise<ListResult<TMenu>>;
174
- };
175
- getJoomlaMenuDoc: (menuId: number | string) => Promise<MenuItem>;
176
- getUserProfile: (userId: number | string) => Promise<NormalizedUserProfile>;
177
- verifyPassword: (username: string, password: string) => Promise<TPasswordVerification>;
178
- }
179
-
180
- interface LegacyActions {
181
- getItemWebDesc: (invMastUid: number) => Promise<TWebDesc | undefined>;
182
- getAlsoBoughtItems: (invMastUid: number) => Promise<ListResult<TRelatedProduct>>;
183
- getItemTags: (invMastUid: number) => Promise<ListResult>;
184
- getStates: (params?: {
185
- twoLetterCode?: string;
186
- }) => Promise<ListResult>;
187
- }
188
-
189
- interface CustomersActions {
190
- getCustomer: (customerId: number) => Promise<CustomerDocument>;
191
- customerLookup: (params: Record<string, unknown>) => Promise<ListResult<CustomerDocument>>;
192
- getCustomerDoc: (customerId: number) => Promise<CustomerDocument>;
193
- getCustomerOrders: (customerId: number, params?: Record<string, unknown>) => Promise<ListResult>;
194
- getCustomerOrderDetail: (customerId: number, orderId: number) => Promise<unknown>;
195
- getCustomerInvoices: (customerId: number, params?: Record<string, unknown>) => Promise<ListResult>;
196
- getCustomerInvoiceDetail: (customerId: number, invoiceNo: number) => Promise<unknown>;
197
- getCustomerQuotes: (customerId: number, params?: Record<string, unknown>) => Promise<ListResult>;
198
- getCustomerQuoteDetail: (customerId: number, quoteNo: number) => Promise<unknown>;
199
- getContacts: (params?: Record<string, unknown>) => Promise<ListResult>;
200
- getShipToAddresses: (customerId: number) => Promise<ListResult>;
201
- }
202
-
203
- /** Standardized response from address validation. */
204
- interface AddressValidationResult {
205
- data: TSmartyStreets | undefined;
206
- status: "success" | "not_found" | "error";
207
- error?: {
208
- message: string;
209
- };
210
- }
211
- interface SmartyStreetsActions {
212
- validateAddress: (params: Record<string, unknown>) => Promise<AddressValidationResult>;
213
- }
214
-
215
- interface P21PimActions {
216
- getInvMastExt: (invMastUid: number) => Promise<unknown>;
217
- listInvMastExt: (params?: Record<string, unknown>) => Promise<ListResult>;
218
- }
219
-
220
- interface AgrSiteActions {
221
- getSettings: (serviceName?: string) => Promise<ListResult>;
222
- getMetaFiles: (params?: Record<string, unknown>) => Promise<ListResult>;
223
- }
224
-
225
- interface AvalaraActions {
226
- calculateTax: (data: Record<string, unknown>) => Promise<unknown>;
227
- }
228
-
229
- interface PaymentsActions {
230
- transactionSetup: (params: Record<string, unknown>) => Promise<TTransactionSetup | undefined>;
231
- accountQuery: (params: Record<string, unknown>) => Promise<TAccountQuery | undefined>;
232
- getSurcharge: (params: Record<string, unknown>) => Promise<TSurcharge | undefined>;
233
- cardInfo: (params: Record<string, unknown>) => Promise<TCardInfo | undefined>;
234
- billingUpdate: (params: Record<string, unknown>) => Promise<TBillingUpdate | undefined>;
235
- validatePayment: (params: Record<string, unknown>) => Promise<TPaymentValidation | undefined>;
236
- }
237
-
238
- interface LogisticsActions {
239
- getFreightRates: (params: Record<string, unknown>) => Promise<ListResult>;
240
- getShipVia: (params?: Record<string, unknown>) => Promise<ListResult>;
241
- }
242
-
243
- interface NexusActions {
244
- createBinTransfer: (data: Record<string, unknown>) => Promise<unknown>;
245
- createReceiving: (data: Record<string, unknown>) => Promise<unknown>;
246
- createTransfer: (data: Record<string, unknown>) => Promise<unknown>;
247
- getPurchaseOrderReceipts: (params?: Record<string, unknown>) => Promise<ListResult>;
248
- getTransferReceipts: (params?: Record<string, unknown>) => Promise<ListResult>;
249
- getTransferShipping: (params?: Record<string, unknown>) => Promise<ListResult>;
250
- }
251
-
252
- interface VmiActions {
253
- getWarehouses: (params?: Record<string, unknown>) => Promise<ListResult>;
254
- getWarehouseAvailability: (warehouseUid: number, params?: Record<string, unknown>) => Promise<ListResult>;
255
- getDistributors: (params?: Record<string, unknown>) => Promise<ListResult>;
256
- getProducts: (params?: Record<string, unknown>) => Promise<ListResult>;
257
- getInventoryProfiles: (params?: Record<string, unknown>) => Promise<ListResult>;
258
- getRestockHeaders: (params?: Record<string, unknown>) => Promise<ListResult>;
259
- getSections: (params?: Record<string, unknown>) => Promise<ListResult>;
260
- }
261
-
262
- interface P21CoreActions {
263
- getAddresses: (params?: Record<string, unknown>) => Promise<ListResult>;
264
- getCompanies: (params?: Record<string, unknown>) => Promise<ListResult>;
265
- getCompany: (companyId: number) => Promise<unknown | undefined>;
266
- getLocations: (params?: Record<string, unknown>) => Promise<ListResult>;
267
- getPaymentTypes: (params?: Record<string, unknown>) => Promise<ListResult>;
268
- getCashDrawers: (params?: Record<string, unknown>) => Promise<ListResult>;
269
- getCodeP21: (params?: Record<string, unknown>) => Promise<ListResult>;
270
- }
271
-
272
- interface P21ApisActions {
273
- getCategories: (params?: Record<string, unknown>) => Promise<ListResult>;
274
- getCategoryDefaults: (categoryId: number) => Promise<unknown | undefined>;
275
- getCompanies: (params?: Record<string, unknown>) => Promise<ListResult>;
276
- getUsers: (params?: Record<string, unknown>) => Promise<ListResult>;
277
- getWebDisplayTypes: (params?: Record<string, unknown>) => Promise<ListResult>;
278
- getWebDisplayTypeDefaults: (id?: number) => Promise<unknown | undefined>;
279
- refreshContacts: (params?: Record<string, unknown>) => Promise<unknown | undefined>;
280
- refreshCustomers: (params?: Record<string, unknown>) => Promise<unknown | undefined>;
281
- }
282
-
283
- interface P21SismActions {
284
- getRecentImports: (params?: Record<string, unknown>) => Promise<ListResult>;
285
- getImport: (importId: string) => Promise<unknown | undefined>;
286
- getImportLines: (importId: number, params?: Record<string, unknown>) => Promise<ListResult>;
287
- getScheduledImports: (params?: Record<string, unknown>) => Promise<ListResult>;
288
- }
289
-
290
- interface AgrWorkActions {
291
- healthCheck: () => Promise<string | undefined>;
292
- ping: () => Promise<string | undefined>;
293
- }
294
-
295
- interface AgrInfoActions {
296
- getContext: (params?: Record<string, unknown>) => Promise<ListResult>;
297
- getRubrics: (params?: Record<string, unknown>) => Promise<ListResult>;
298
- getMicroservices: (params?: Record<string, unknown>) => Promise<ListResult>;
299
- generateAkasha: (data?: Record<string, unknown>) => Promise<unknown | undefined>;
300
- generateJoomla: (data?: Record<string, unknown>) => Promise<unknown | undefined>;
301
- }
302
-
303
- interface Basecamp2Actions {
304
- getTodos: (params?: Record<string, unknown>) => Promise<ListResult>;
305
- getTodo: (todoId: number) => Promise<unknown>;
306
- getTodosSummary: (params?: Record<string, unknown>) => Promise<ListResult>;
307
- getComments: (params?: Record<string, unknown>) => Promise<ListResult>;
308
- getPeople: (params?: Record<string, unknown>) => Promise<ListResult>;
309
- getProjects: (params?: Record<string, unknown>) => Promise<ListResult>;
310
- getEvents: (params?: Record<string, unknown>) => Promise<ListResult>;
311
- getMetrics: (params?: Record<string, unknown>) => Promise<ListResult>;
312
- getTodolists: (params?: Record<string, unknown>) => Promise<ListResult>;
313
- }
314
-
315
- interface BrandFolderActions {
316
- getCategories: (params?: Record<string, unknown>) => Promise<ListResult>;
317
- getCategory: (categoryId: string) => Promise<unknown>;
318
- createFocus: (categoryId: string, data: Record<string, unknown>) => Promise<unknown | undefined>;
319
- }
320
-
321
- interface GregorovichActions {
322
- askChatGpt: (params: Record<string, unknown>) => Promise<unknown | undefined>;
323
- getDocuments: (params?: Record<string, unknown>) => Promise<ListResult>;
324
- createDocument: (data: Record<string, unknown>) => Promise<unknown | undefined>;
325
- generateOllama: (data: Record<string, unknown>) => Promise<unknown | undefined>;
326
- }
327
-
328
- interface SlackActions {
329
- sendWebhook: (data: Record<string, unknown>) => Promise<unknown | undefined>;
330
- getWebhooks: (params?: Record<string, unknown>) => Promise<ListResult>;
331
- }
332
-
333
- interface FavoritesActions {
334
- getFavorites: (userId: number) => Promise<ListResult>;
335
- addFavorite: (userId: number, invMastUid: number) => Promise<unknown>;
336
- removeFavorite: (userId: number, invMastUid: number) => Promise<void>;
337
- }
338
-
339
- interface WishlistActions {
340
- getWishlists: (userId: number) => Promise<ListResult>;
341
- createWishlist: (userId: number, data: {
342
- name: string;
343
- description?: string;
344
- }) => Promise<unknown>;
345
- getWishlistDetail: (userId: number, wishlistId: number) => Promise<unknown>;
346
- deleteWishlist: (userId: number, wishlistId: number) => Promise<void>;
347
- addWishlistItems: (userId: number, wishlistId: number, items: {
348
- invMastUid: number;
349
- }[]) => Promise<unknown>;
350
- removeWishlistItem: (userId: number, wishlistId: number, lineId: number) => Promise<void>;
351
- }
352
-
353
- interface SiteActionsConfig {
354
- /**
355
- * Cache key prefix shared across all services.
356
- *
357
- * Defaults to `"${siteId}:"` extracted from the API client.
358
- * The site ID is the canonical cache namespace — most sites should
359
- * NOT set this and let it derive automatically.
360
- *
361
- * Only override when migrating from a legacy prefix (e.g. `"ampro:"`
362
- * instead of the site ID `"ampro-online"`).
363
- */
364
- cachePrefix?: string;
365
- /** Default edge cache TTL in seconds */
366
- edgeCache?: EdgeCacheValue;
367
- /** Default Redis TTL in seconds */
368
- redisTtl?: number;
369
- /** Long-lived edge cache TTL for rarely-changing data */
370
- longEdgeCache?: EdgeCacheValue;
371
- /** Long-lived Redis TTL for rarely-changing data */
372
- longRedisTtl?: number;
373
- /** Default contact ID for commerce operations. Falls back to process.env.DEFAULT_CONTACT_ID. */
374
- defaultContactId?: string | number;
375
- /** Default customer ID for pricing and commerce. Falls back to process.env.DEFAULT_CUSTOMER_ID. */
376
- defaultCustomerId?: string | number;
377
- /** Default company ID. Falls back to process.env.DEFAULT_COMPANY_ID. Not yet consumed by any factory. */
378
- defaultCompanyId?: string | number;
379
- /** UOM conversion function for commerce (e.g. "EA" → "EACH") */
380
- convertUnitOfMeasure?: (uom: string) => string;
381
- /** Pricing-specific overrides */
382
- pricing?: {
383
- taxRedisTtl?: number;
384
- };
385
- /** Items-specific overrides */
386
- items?: {
387
- sortChildren?: boolean;
388
- sortByPrefix?: string;
389
- };
390
- /** Search-specific overrides */
391
- search?: {
392
- defaultSourceFields?: string;
393
- };
394
- /** Payments-specific overrides */
395
- payments?: {
396
- mode?: string;
397
- };
398
- /** Shipping config — fromAddress is required for shipping to work */
399
- shipping?: {
400
- fromAddress: ShippingAddress;
401
- defaultServiceCodes?: string[];
402
- };
403
- /** VMI-specific overrides */
404
- vmi?: {
405
- shortRedisTtl?: number;
406
- };
407
- }
408
- interface SiteActions {
409
- pricing: PricingActions;
410
- items: ItemActions;
411
- commerce: CommerceActions;
412
- search: SearchActions;
413
- orders: OrderActions;
414
- shipping: ShippingActions;
415
- joomla: JoomlaActions;
416
- legacy: LegacyActions;
417
- customers: CustomersActions;
418
- smartyStreets: SmartyStreetsActions;
419
- p21Pim: P21PimActions;
420
- agrSite: AgrSiteActions;
421
- avalara: AvalaraActions;
422
- payments: PaymentsActions;
423
- logistics: LogisticsActions;
424
- nexus: NexusActions;
425
- vmi: VmiActions;
426
- p21Core: P21CoreActions;
427
- p21Apis: P21ApisActions;
428
- p21Sism: P21SismActions;
429
- agrWork: AgrWorkActions;
430
- agrInfo: AgrInfoActions;
431
- basecamp2: Basecamp2Actions;
432
- brandFolder: BrandFolderActions;
433
- gregorovich: GregorovichActions;
434
- slack: SlackActions;
435
- favorites: FavoritesActions;
436
- wishlists: WishlistActions;
437
- }
438
- /**
439
- * Creates a unified site actions object with all service factories.
440
- *
441
- * Shared config (cachePrefix, edgeCache, redisTtl, etc.) is passed to all
442
- * services automatically. Per-service overrides are available for services
443
- * with additional configuration.
444
- *
445
- * @example
446
- * ```ts
447
- * import { createSiteActions } from "@simpleapps-com/augur-server";
448
- * import { getAugurClient } from "./augur-client";
449
- *
450
- * // defaultCustomerId/defaultContactId fall back to DEFAULT_CUSTOMER_ID/DEFAULT_CONTACT_ID
451
- * // env vars when not provided — no need to set them if CDK injects them.
452
- * export const actions = createSiteActions(getAugurClient(), {
453
- * convertUnitOfMeasure: (uom) => uom === "EA" ? "EACH" : uom,
454
- * items: { sortChildren: true },
455
- * shipping: {
456
- * fromAddress: { address1: "123 Main", city: "Provo", state: "UT", postalCode: "84606" },
457
- * defaultServiceCodes: ["03"],
458
- * },
459
- * });
460
- *
461
- * // Usage:
462
- * const price = await actions.pricing.getItemPrice("ITEM-1");
463
- * const doc = await actions.items.getInvMastDoc("ITEM-1");
464
- * const cart = await actions.commerce.cartHdrLookup({ userId: 123 });
465
- * ```
466
- */
467
- declare function createSiteActions<TApi extends object>(api: TApi, config?: SiteActionsConfig): SiteActions;
468
-
469
- export { type PaginatedResult as P, type SiteActions as S, type SiteActionsConfig as a, createSiteActions as c, paginateOffset as p };