@simpleapps-com/augur-server 0.4.2 → 0.4.4
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/dist/{chunk-I7EWYSPA.js → chunk-R3XKAWHN.js} +17 -1
- package/dist/chunk-R3XKAWHN.js.map +1 -0
- package/dist/index.d.ts +8 -1
- package/dist/index.js +13 -28
- package/dist/index.js.map +1 -1
- package/dist/prefetch.js +8 -13
- package/dist/prefetch.js.map +1 -1
- package/package.json +4 -4
- package/dist/chunk-I7EWYSPA.js.map +0 -1
package/dist/prefetch.js
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import {
|
|
2
|
+
batchFetch,
|
|
2
3
|
getServerQueryClient
|
|
3
|
-
} from "./chunk-
|
|
4
|
+
} from "./chunk-R3XKAWHN.js";
|
|
4
5
|
|
|
5
6
|
// src/prefetch.ts
|
|
6
7
|
import {
|
|
@@ -36,19 +37,13 @@ function createPrefetchUtilities(api, config = {}) {
|
|
|
36
37
|
async function prefetchBatchItemPrices(itemIds, customerId, quantity = 1) {
|
|
37
38
|
const qc = getQueryClient();
|
|
38
39
|
const custId = resolveCustomerId(customerId);
|
|
39
|
-
const
|
|
40
|
-
itemIds
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
})
|
|
40
|
+
const prices = await batchFetch(
|
|
41
|
+
itemIds,
|
|
42
|
+
(id) => getItemPriceOptions(api, id, custId, quantity, cache).queryFn(),
|
|
43
|
+
(id) => id
|
|
44
44
|
);
|
|
45
|
-
for (const [id, data] of
|
|
46
|
-
|
|
47
|
-
qc.setQueryData(
|
|
48
|
-
getItemPriceKey(id, custId, quantity),
|
|
49
|
-
data
|
|
50
|
-
);
|
|
51
|
-
}
|
|
45
|
+
for (const [id, data] of Object.entries(prices)) {
|
|
46
|
+
qc.setQueryData(getItemPriceKey(id, custId, quantity), data);
|
|
52
47
|
}
|
|
53
48
|
}
|
|
54
49
|
async function prefetchProductListingPrices(itemIds, customerId, maxItems) {
|
package/dist/prefetch.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/prefetch.ts"],"sourcesContent":["import type { QueryClient } from \"@tanstack/react-query\";\nimport {\n getItemPriceKey,\n getItemPriceOptions,\n getItemCategoryOptions,\n getInvMastOptions,\n getInvMastDocOptions,\n getInvMastStockOptions,\n getItemDetailsOptions,\n getItemAttributesOptions,\n getProductCategoryOptions,\n getProductSearchOptions,\n getCategoryItemsInfiniteOptions,\n getItemSearchInfiniteOptions,\n getJoomlaContentOptions,\n getJoomlaContentListOptions,\n} from \"@simpleapps-com/augur-hooks/server\";\nimport type {\n AugurApiClient,\n PageData,\n} from \"@simpleapps-com/augur-hooks/server\";\nimport type {\n TItemsFilters,\n TJoomlaContentFilters,\n} from \"@simpleapps-com/augur-utils\";\nimport { getServerQueryClient } from \"./server-query-client\";\n\n/**\n * Cache configuration for prefetch utilities.\n * Re-exports the CacheConfig shape from augur-hooks so consumers\n * don't need a separate import.\n */\nexport type { CacheConfig } from \"@simpleapps-com/augur-hooks/server\";\n\n/** Options for item category prefetch. */\nexport interface PrefetchItemCategoryApiOptions {\n childrenFilter?: string;\n childrenLimit?: number;\n childrenOffset?: number;\n classId5List?: string;\n filters?: Record<string, string>;\n orderBy?: string;\n path?: string;\n productCollection?: string;\n rootItemCategoryId?: string;\n}\n\n/** Configuration for createPrefetchUtilities. */\nexport interface PrefetchConfig {\n /** Cache configuration passed through to query options. */\n cache?: import(\"@simpleapps-com/augur-hooks/server\").CacheConfig;\n /** Default customer ID for pricing prefetch. */\n defaultCustomerId?: string | number;\n}\n\n/** Prefetch utilities returned by createPrefetchUtilities. */\nexport interface PrefetchUtilities {\n prefetchItemPrice: (\n itemId: string,\n customerId?: string | number,\n quantity?: number,\n ) => Promise<void>;\n\n prefetchBatchItemPrices: (\n itemIds: string[],\n customerId?: string | number,\n quantity?: number,\n ) => Promise<void>;\n\n prefetchProductListingPrices: (\n itemIds: string[],\n customerId?: string | number,\n maxItems?: number,\n ) => Promise<void>;\n\n prefetchItemCategory: (\n itemCategoryUid: number,\n apiOptions?: PrefetchItemCategoryApiOptions,\n ) => Promise<void>;\n\n prefetchInvMast: (\n invMastUid: number,\n itemId: string,\n ) => Promise<void>;\n\n prefetchInvMastStock: (\n invMastUid: number | string,\n ) => Promise<void>;\n\n prefetchItemDetails: (\n itemId: number | string,\n ) => Promise<void>;\n\n prefetchItemAttributes: (\n itemCategoryUid: number | string,\n ) => Promise<void>;\n\n prefetchProductSearch: (\n pageData: PageData,\n ) => Promise<void>;\n\n prefetchJoomlaContent: (\n articleId: number | string,\n ) => Promise<void>;\n\n prefetchInvMastDoc: (\n invMastUid: number,\n itemId: string,\n includePricing?: \"Y\" | \"N\",\n ) => Promise<void>;\n\n prefetchProductCategory: (\n itemCategoryUid: number | string,\n ) => Promise<void>;\n\n prefetchCategoryItemsFirstPage: (\n itemCategoryUid: number,\n itemsFilters: TItemsFilters,\n ) => Promise<void>;\n\n prefetchSearchResultsFirstPage: (\n itemsFilters: TItemsFilters,\n itemCategoryUid?: number | string,\n ) => Promise<void>;\n\n prefetchJoomlaContentList: (\n categoryId: number | string,\n filters?: Partial<TJoomlaContentFilters>,\n ) => Promise<void>;\n}\n\n/**\n * Creates SSR prefetch utilities that pre-populate the React Query cache\n * during server rendering. Eliminates loading states on first paint.\n *\n * Uses the same query keys as augur-hooks so client-side hooks hydrate\n * instantly from prefetched data — no duplicate requests.\n *\n * @example\n * ```ts\n * // lib/prefetch.ts\n * import { createPrefetchUtilities } from \"@simpleapps-com/augur-server/prefetch\";\n * import { getAugurClient } from \"./augur-client\";\n *\n * export const prefetch = createPrefetchUtilities(getAugurClient(), {\n * defaultCustomerId: process.env.NEXT_PUBLIC_DEFAULT_CUSTOMER_ID,\n * cache: augurCache,\n * });\n *\n * // In a server component:\n * export default async function ItemPage({ params }: { params: { id: string } }) {\n * await prefetch.prefetchItemPrice(params.id);\n * await prefetch.prefetchItemDetails(params.id);\n * return <ItemDetail itemId={params.id} />;\n * }\n *\n * // Batch prefetch for listing pages:\n * export default async function CategoryPage() {\n * const itemIds = await getItemIdsForCategory(categoryId);\n * await prefetch.prefetchBatchItemPrices(itemIds);\n * return <ProductGrid items={itemIds} />;\n * }\n * ```\n */\nexport function createPrefetchUtilities(\n api: AugurApiClient,\n config: PrefetchConfig = {},\n): PrefetchUtilities {\n const { cache, defaultCustomerId } = config;\n\n function getQueryClient(): QueryClient {\n return getServerQueryClient();\n }\n\n function resolveCustomerId(\n explicit: string | number | undefined,\n ): string | number | undefined {\n return explicit ?? defaultCustomerId;\n }\n\n async function prefetchItemPrice(\n itemId: string,\n customerId?: string | number,\n quantity = 1,\n ): Promise<void> {\n const qc = getQueryClient();\n const custId = resolveCustomerId(customerId);\n const options = getItemPriceOptions(api, itemId, custId, quantity, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchBatchItemPrices(\n itemIds: string[],\n customerId?: string | number,\n quantity = 1,\n ): Promise<void> {\n const qc = getQueryClient();\n const custId = resolveCustomerId(customerId);\n\n // Fetch all prices in parallel\n const results = await Promise.all(\n itemIds.map((id) => {\n const options = getItemPriceOptions(api, id, custId, quantity, cache);\n return options\n .queryFn()\n .then((data) => [id, data] as const)\n .catch(() => [id, null] as const);\n }),\n );\n\n // Populate individual query caches so each component finds its data\n for (const [id, data] of results) {\n if (data) {\n qc.setQueryData(\n getItemPriceKey(id, custId, quantity),\n data,\n );\n }\n }\n }\n\n async function prefetchProductListingPrices(\n itemIds: string[],\n customerId?: string | number,\n maxItems?: number,\n ): Promise<void> {\n const limited = maxItems ? itemIds.slice(0, maxItems) : itemIds;\n await prefetchBatchItemPrices(limited, customerId);\n }\n\n async function prefetchItemCategory(\n itemCategoryUid: number,\n apiOptions?: PrefetchItemCategoryApiOptions,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getItemCategoryOptions(api, itemCategoryUid, apiOptions, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchInvMast(\n invMastUid: number,\n itemId: string,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getInvMastOptions(api, invMastUid, itemId, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchInvMastStock(\n invMastUid: number | string,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getInvMastStockOptions(api, invMastUid, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchItemDetails(\n itemId: number | string,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getItemDetailsOptions(api, itemId, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchItemAttributes(\n itemCategoryUid: number | string,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getItemAttributesOptions(api, itemCategoryUid, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchProductSearch(\n pageData: PageData,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getProductSearchOptions(api, pageData, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchJoomlaContent(\n articleId: number | string,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getJoomlaContentOptions(api, articleId, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchInvMastDoc(\n invMastUid: number,\n itemId: string,\n includePricing: \"Y\" | \"N\" = \"N\",\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getInvMastDocOptions(api, invMastUid, itemId, includePricing, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchProductCategory(\n itemCategoryUid: number | string,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getProductCategoryOptions(api, itemCategoryUid, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchCategoryItemsFirstPage(\n itemCategoryUid: number,\n itemsFilters: TItemsFilters,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getCategoryItemsInfiniteOptions(\n api, itemCategoryUid, itemsFilters, cache,\n );\n await qc.prefetchInfiniteQuery({ ...options, pages: 1 });\n }\n\n async function prefetchSearchResultsFirstPage(\n itemsFilters: TItemsFilters,\n itemCategoryUid?: number | string,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getItemSearchInfiniteOptions(\n api, itemsFilters, itemCategoryUid, cache,\n );\n await qc.prefetchInfiniteQuery({ ...options, pages: 1 });\n }\n\n async function prefetchJoomlaContentList(\n categoryId: number | string,\n filters?: Partial<TJoomlaContentFilters>,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getJoomlaContentListOptions(api, categoryId, filters, cache);\n await qc.prefetchQuery(options);\n }\n\n return {\n prefetchItemPrice,\n prefetchBatchItemPrices,\n prefetchProductListingPrices,\n prefetchItemCategory,\n prefetchInvMast,\n prefetchInvMastStock,\n prefetchItemDetails,\n prefetchItemAttributes,\n prefetchProductSearch,\n prefetchInvMastDoc,\n prefetchProductCategory,\n prefetchCategoryItemsFirstPage,\n prefetchSearchResultsFirstPage,\n prefetchJoomlaContent,\n prefetchJoomlaContentList,\n };\n}\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":["../src/prefetch.ts"],"sourcesContent":["import type { QueryClient } from \"@tanstack/react-query\";\nimport {\n getItemPriceKey,\n getItemPriceOptions,\n getItemCategoryOptions,\n getInvMastOptions,\n getInvMastDocOptions,\n getInvMastStockOptions,\n getItemDetailsOptions,\n getItemAttributesOptions,\n getProductCategoryOptions,\n getProductSearchOptions,\n getCategoryItemsInfiniteOptions,\n getItemSearchInfiniteOptions,\n getJoomlaContentOptions,\n getJoomlaContentListOptions,\n} from \"@simpleapps-com/augur-hooks/server\";\nimport type {\n AugurApiClient,\n PageData,\n} from \"@simpleapps-com/augur-hooks/server\";\nimport type {\n TItemsFilters,\n TJoomlaContentFilters,\n} from \"@simpleapps-com/augur-utils\";\nimport { getServerQueryClient } from \"./server-query-client\";\nimport { batchFetch } from \"./utils/batch-fetch\";\n\n/**\n * Cache configuration for prefetch utilities.\n * Re-exports the CacheConfig shape from augur-hooks so consumers\n * don't need a separate import.\n */\nexport type { CacheConfig } from \"@simpleapps-com/augur-hooks/server\";\n\n/** Options for item category prefetch. */\nexport interface PrefetchItemCategoryApiOptions {\n childrenFilter?: string;\n childrenLimit?: number;\n childrenOffset?: number;\n classId5List?: string;\n filters?: Record<string, string>;\n orderBy?: string;\n path?: string;\n productCollection?: string;\n rootItemCategoryId?: string;\n}\n\n/** Configuration for createPrefetchUtilities. */\nexport interface PrefetchConfig {\n /** Cache configuration passed through to query options. */\n cache?: import(\"@simpleapps-com/augur-hooks/server\").CacheConfig;\n /** Default customer ID for pricing prefetch. */\n defaultCustomerId?: string | number;\n}\n\n/** Prefetch utilities returned by createPrefetchUtilities. */\nexport interface PrefetchUtilities {\n prefetchItemPrice: (\n itemId: string,\n customerId?: string | number,\n quantity?: number,\n ) => Promise<void>;\n\n prefetchBatchItemPrices: (\n itemIds: string[],\n customerId?: string | number,\n quantity?: number,\n ) => Promise<void>;\n\n prefetchProductListingPrices: (\n itemIds: string[],\n customerId?: string | number,\n maxItems?: number,\n ) => Promise<void>;\n\n prefetchItemCategory: (\n itemCategoryUid: number,\n apiOptions?: PrefetchItemCategoryApiOptions,\n ) => Promise<void>;\n\n prefetchInvMast: (\n invMastUid: number,\n itemId: string,\n ) => Promise<void>;\n\n prefetchInvMastStock: (\n invMastUid: number | string,\n ) => Promise<void>;\n\n prefetchItemDetails: (\n itemId: number | string,\n ) => Promise<void>;\n\n prefetchItemAttributes: (\n itemCategoryUid: number | string,\n ) => Promise<void>;\n\n prefetchProductSearch: (\n pageData: PageData,\n ) => Promise<void>;\n\n prefetchJoomlaContent: (\n articleId: number | string,\n ) => Promise<void>;\n\n prefetchInvMastDoc: (\n invMastUid: number,\n itemId: string,\n includePricing?: \"Y\" | \"N\",\n ) => Promise<void>;\n\n prefetchProductCategory: (\n itemCategoryUid: number | string,\n ) => Promise<void>;\n\n prefetchCategoryItemsFirstPage: (\n itemCategoryUid: number,\n itemsFilters: TItemsFilters,\n ) => Promise<void>;\n\n prefetchSearchResultsFirstPage: (\n itemsFilters: TItemsFilters,\n itemCategoryUid?: number | string,\n ) => Promise<void>;\n\n prefetchJoomlaContentList: (\n categoryId: number | string,\n filters?: Partial<TJoomlaContentFilters>,\n ) => Promise<void>;\n}\n\n/**\n * Creates SSR prefetch utilities that pre-populate the React Query cache\n * during server rendering. Eliminates loading states on first paint.\n *\n * Uses the same query keys as augur-hooks so client-side hooks hydrate\n * instantly from prefetched data — no duplicate requests.\n *\n * @example\n * ```ts\n * // lib/prefetch.ts\n * import { createPrefetchUtilities } from \"@simpleapps-com/augur-server/prefetch\";\n * import { getAugurClient } from \"./augur-client\";\n *\n * export const prefetch = createPrefetchUtilities(getAugurClient(), {\n * defaultCustomerId: process.env.NEXT_PUBLIC_DEFAULT_CUSTOMER_ID,\n * cache: augurCache,\n * });\n *\n * // In a server component:\n * export default async function ItemPage({ params }: { params: { id: string } }) {\n * await prefetch.prefetchItemPrice(params.id);\n * await prefetch.prefetchItemDetails(params.id);\n * return <ItemDetail itemId={params.id} />;\n * }\n *\n * // Batch prefetch for listing pages:\n * export default async function CategoryPage() {\n * const itemIds = await getItemIdsForCategory(categoryId);\n * await prefetch.prefetchBatchItemPrices(itemIds);\n * return <ProductGrid items={itemIds} />;\n * }\n * ```\n */\nexport function createPrefetchUtilities(\n api: AugurApiClient,\n config: PrefetchConfig = {},\n): PrefetchUtilities {\n const { cache, defaultCustomerId } = config;\n\n function getQueryClient(): QueryClient {\n return getServerQueryClient();\n }\n\n function resolveCustomerId(\n explicit: string | number | undefined,\n ): string | number | undefined {\n return explicit ?? defaultCustomerId;\n }\n\n async function prefetchItemPrice(\n itemId: string,\n customerId?: string | number,\n quantity = 1,\n ): Promise<void> {\n const qc = getQueryClient();\n const custId = resolveCustomerId(customerId);\n const options = getItemPriceOptions(api, itemId, custId, quantity, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchBatchItemPrices(\n itemIds: string[],\n customerId?: string | number,\n quantity = 1,\n ): Promise<void> {\n const qc = getQueryClient();\n const custId = resolveCustomerId(customerId);\n\n const prices = await batchFetch(\n itemIds,\n (id) => getItemPriceOptions(api, id, custId, quantity, cache).queryFn(),\n (id) => id,\n );\n\n for (const [id, data] of Object.entries(prices)) {\n qc.setQueryData(getItemPriceKey(id, custId, quantity), data);\n }\n }\n\n async function prefetchProductListingPrices(\n itemIds: string[],\n customerId?: string | number,\n maxItems?: number,\n ): Promise<void> {\n const limited = maxItems ? itemIds.slice(0, maxItems) : itemIds;\n await prefetchBatchItemPrices(limited, customerId);\n }\n\n async function prefetchItemCategory(\n itemCategoryUid: number,\n apiOptions?: PrefetchItemCategoryApiOptions,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getItemCategoryOptions(api, itemCategoryUid, apiOptions, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchInvMast(\n invMastUid: number,\n itemId: string,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getInvMastOptions(api, invMastUid, itemId, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchInvMastStock(\n invMastUid: number | string,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getInvMastStockOptions(api, invMastUid, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchItemDetails(\n itemId: number | string,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getItemDetailsOptions(api, itemId, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchItemAttributes(\n itemCategoryUid: number | string,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getItemAttributesOptions(api, itemCategoryUid, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchProductSearch(\n pageData: PageData,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getProductSearchOptions(api, pageData, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchJoomlaContent(\n articleId: number | string,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getJoomlaContentOptions(api, articleId, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchInvMastDoc(\n invMastUid: number,\n itemId: string,\n includePricing: \"Y\" | \"N\" = \"N\",\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getInvMastDocOptions(api, invMastUid, itemId, includePricing, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchProductCategory(\n itemCategoryUid: number | string,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getProductCategoryOptions(api, itemCategoryUid, cache);\n await qc.prefetchQuery(options);\n }\n\n async function prefetchCategoryItemsFirstPage(\n itemCategoryUid: number,\n itemsFilters: TItemsFilters,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getCategoryItemsInfiniteOptions(\n api, itemCategoryUid, itemsFilters, cache,\n );\n await qc.prefetchInfiniteQuery({ ...options, pages: 1 });\n }\n\n async function prefetchSearchResultsFirstPage(\n itemsFilters: TItemsFilters,\n itemCategoryUid?: number | string,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getItemSearchInfiniteOptions(\n api, itemsFilters, itemCategoryUid, cache,\n );\n await qc.prefetchInfiniteQuery({ ...options, pages: 1 });\n }\n\n async function prefetchJoomlaContentList(\n categoryId: number | string,\n filters?: Partial<TJoomlaContentFilters>,\n ): Promise<void> {\n const qc = getQueryClient();\n const options = getJoomlaContentListOptions(api, categoryId, filters, cache);\n await qc.prefetchQuery(options);\n }\n\n return {\n prefetchItemPrice,\n prefetchBatchItemPrices,\n prefetchProductListingPrices,\n prefetchItemCategory,\n prefetchInvMast,\n prefetchInvMastStock,\n prefetchItemDetails,\n prefetchItemAttributes,\n prefetchProductSearch,\n prefetchInvMastDoc,\n prefetchProductCategory,\n prefetchCategoryItemsFirstPage,\n prefetchSearchResultsFirstPage,\n prefetchJoomlaContent,\n prefetchJoomlaContentList,\n };\n}\n"],"mappings":"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","names":[]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@simpleapps-com/augur-server",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.4",
|
|
4
4
|
"description": "Server-side utilities for Augur ecommerce sites (Redis caching, SDK helpers, auth)",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -41,7 +41,7 @@
|
|
|
41
41
|
],
|
|
42
42
|
"dependencies": {
|
|
43
43
|
"valibot": "^1.0.0",
|
|
44
|
-
"@simpleapps-com/augur-utils": "0.4.
|
|
44
|
+
"@simpleapps-com/augur-utils": "0.4.4"
|
|
45
45
|
},
|
|
46
46
|
"peerDependencies": {
|
|
47
47
|
"@simpleapps-com/augur-api": "^0.9.11",
|
|
@@ -50,7 +50,7 @@
|
|
|
50
50
|
"next": "^16.1.6",
|
|
51
51
|
"next-auth": ">=5.0.0-beta.30",
|
|
52
52
|
"react": "^19.0.0",
|
|
53
|
-
"@simpleapps-com/augur-hooks": "0.4.
|
|
53
|
+
"@simpleapps-com/augur-hooks": "0.4.4"
|
|
54
54
|
},
|
|
55
55
|
"peerDependenciesMeta": {
|
|
56
56
|
"ioredis": {
|
|
@@ -73,7 +73,7 @@
|
|
|
73
73
|
"tsup": "^8.5.0",
|
|
74
74
|
"vitest": "^3.2.0",
|
|
75
75
|
"@augur-packages/tsconfig": "0.0.0",
|
|
76
|
-
"@simpleapps-com/augur-hooks": "0.4.
|
|
76
|
+
"@simpleapps-com/augur-hooks": "0.4.4"
|
|
77
77
|
},
|
|
78
78
|
"scripts": {
|
|
79
79
|
"build": "tsup",
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/server-query-client.ts"],"sourcesContent":["import { cache } from \"react\";\nimport { QueryClient } from \"@tanstack/react-query\";\nimport { CACHE_CONFIG } from \"@simpleapps-com/augur-utils\";\n\n/**\n * Creates a server-side query client optimised for prefetching.\n *\n * - No persistence (server-only)\n * - Longer cache times for prefetched data\n * - No retries (fail fast on server)\n * - No refetching (server renders are one-shot)\n */\nexport function createServerQueryClient(): QueryClient {\n return new QueryClient({\n defaultOptions: {\n queries: {\n staleTime: CACHE_CONFIG.STATIC.staleTime,\n gcTime: CACHE_CONFIG.STATIC.staleTime,\n retry: 0,\n refetchOnMount: false,\n refetchOnWindowFocus: false,\n refetchOnReconnect: false,\n },\n },\n });\n}\n\n/**\n * Returns a per-request singleton QueryClient for React Server Components.\n *\n * React's `cache()` deduplicates calls within a single server request,\n * so each request gets its own QueryClient while avoiding the cross-request\n * state leakage that a module-level singleton would cause.\n */\nexport const getServerQueryClient = cache(\n (): QueryClient => createServerQueryClient(),\n);\n"],"mappings":";AAAA,SAAS,aAAa;AACtB,SAAS,mBAAmB;AAC5B,SAAS,oBAAoB;AAUtB,SAAS,0BAAuC;AACrD,SAAO,IAAI,YAAY;AAAA,IACrB,gBAAgB;AAAA,MACd,SAAS;AAAA,QACP,WAAW,aAAa,OAAO;AAAA,QAC/B,QAAQ,aAAa,OAAO;AAAA,QAC5B,OAAO;AAAA,QACP,gBAAgB;AAAA,QAChB,sBAAsB;AAAA,QACtB,oBAAoB;AAAA,MACtB;AAAA,IACF;AAAA,EACF,CAAC;AACH;AASO,IAAM,uBAAuB;AAAA,EAClC,MAAmB,wBAAwB;AAC7C;","names":[]}
|