@simpleapps-com/augur-server 2026.11.4 → 2026.11.6

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 (80) hide show
  1. package/EXPORTS.md +28 -1
  2. package/README.md +42 -14
  3. package/dist/actions/action-rules.d.ts +99 -0
  4. package/dist/actions/action-rules.d.ts.map +1 -0
  5. package/dist/actions/agr-site.d.ts +7 -15
  6. package/dist/actions/agr-site.d.ts.map +1 -1
  7. package/dist/actions/commerce.d.ts.map +1 -1
  8. package/dist/actions/customers.d.ts +12 -15
  9. package/dist/actions/customers.d.ts.map +1 -1
  10. package/dist/actions/favorites.d.ts +9 -12
  11. package/dist/actions/favorites.d.ts.map +1 -1
  12. package/dist/actions/gregorovich.d.ts +7 -15
  13. package/dist/actions/gregorovich.d.ts.map +1 -1
  14. package/dist/actions/items.d.ts +8 -20
  15. package/dist/actions/items.d.ts.map +1 -1
  16. package/dist/actions/joomla.d.ts +8 -14
  17. package/dist/actions/joomla.d.ts.map +1 -1
  18. package/dist/actions/legacy.d.ts +10 -20
  19. package/dist/actions/legacy.d.ts.map +1 -1
  20. package/dist/actions/orders.d.ts +7 -14
  21. package/dist/actions/orders.d.ts.map +1 -1
  22. package/dist/actions/read-specs.d.ts +119 -0
  23. package/dist/actions/read-specs.d.ts.map +1 -0
  24. package/dist/actions/site.d.ts.map +1 -1
  25. package/dist/actions/vmi.d.ts +10 -16
  26. package/dist/actions/vmi.d.ts.map +1 -1
  27. package/dist/actions/wishlists.d.ts +11 -13
  28. package/dist/actions/wishlists.d.ts.map +1 -1
  29. package/dist/api.js +3 -2
  30. package/dist/api.js.map +1 -1
  31. package/dist/auth.js +3 -2
  32. package/dist/cache/redis-client.d.ts.map +1 -1
  33. package/dist/cache/redis-rules.d.ts +21 -0
  34. package/dist/cache/redis-rules.d.ts.map +1 -0
  35. package/dist/cache/spec-read.d.ts +39 -0
  36. package/dist/cache/spec-read.d.ts.map +1 -0
  37. package/dist/cache/with-cache.d.ts +2 -2
  38. package/dist/cache/with-cache.d.ts.map +1 -1
  39. package/dist/{chunk-WR7WT2FI.js → chunk-2RAKVFB5.js} +30 -9
  40. package/dist/chunk-2RAKVFB5.js.map +1 -0
  41. package/dist/{chunk-F7QWHMHH.js → chunk-4JPJQHT6.js} +2 -2
  42. package/dist/chunk-JIYVQWXK.js +10 -0
  43. package/dist/chunk-JIYVQWXK.js.map +1 -0
  44. package/dist/{chunk-34NCJS52.js → chunk-SFXO74RC.js} +874 -719
  45. package/dist/chunk-SFXO74RC.js.map +1 -0
  46. package/dist/chunk-V76GZZF3.js +66 -0
  47. package/dist/chunk-V76GZZF3.js.map +1 -0
  48. package/dist/{chunk-B4MGIUCU.js → chunk-Z53NEFEQ.js} +17 -16
  49. package/dist/chunk-Z53NEFEQ.js.map +1 -0
  50. package/dist/hooks.js +3 -2
  51. package/dist/hooks.js.map +1 -1
  52. package/dist/index.js +4 -2
  53. package/dist/index.js.map +1 -1
  54. package/dist/query-action.d.ts +24 -1
  55. package/dist/query-action.d.ts.map +1 -1
  56. package/dist/query-action.js +7 -2
  57. package/dist/read-rules.d.ts +45 -0
  58. package/dist/read-rules.d.ts.map +1 -0
  59. package/dist/rules.d.ts +16 -0
  60. package/dist/rules.d.ts.map +1 -1
  61. package/dist/server-site-registry.d.ts.map +1 -1
  62. package/dist/server-site.d.ts.map +1 -1
  63. package/dist/site.js +24 -14
  64. package/dist/site.js.map +1 -1
  65. package/dist/sitemap-rules.d.ts +154 -0
  66. package/dist/sitemap-rules.d.ts.map +1 -0
  67. package/dist/sitemap.d.ts +80 -0
  68. package/dist/sitemap.d.ts.map +1 -0
  69. package/dist/sitemap.js +242 -0
  70. package/dist/sitemap.js.map +1 -0
  71. package/dist/testing.js +4 -2
  72. package/dist/testing.js.map +1 -1
  73. package/dist/utils/read-all-pages.d.ts +17 -0
  74. package/dist/utils/read-all-pages.d.ts.map +1 -0
  75. package/llms.txt +54 -1
  76. package/package.json +9 -5
  77. package/dist/chunk-34NCJS52.js.map +0 -1
  78. package/dist/chunk-B4MGIUCU.js.map +0 -1
  79. package/dist/chunk-WR7WT2FI.js.map +0 -1
  80. /package/dist/{chunk-F7QWHMHH.js.map → chunk-4JPJQHT6.js.map} +0 -0
package/EXPORTS.md CHANGED
@@ -31,7 +31,7 @@
31
31
  | `unwrap` | value | |
32
32
  | `unwrapOr` | value | |
33
33
  | `verifyRecaptcha` | function | Server-side Google reCAPTCHA v3 verification. Used by API routes that accept public form submissions. |
34
- | `withServerCache` | function | Caches an action's shaped value. |
34
+ | `withServerCache` | const | Caches an action's shaped value. |
35
35
 
36
36
  ### Types
37
37
 
@@ -115,6 +115,8 @@
115
115
  | `getSessionCredentials` | function | Resolve session credentials from the Auth.js JWT cookie. |
116
116
  | `queryAction` | function | The SDK call `callSdk` makes (everything above), answered as its envelope's data. |
117
117
  | `queryActionRaw` | function | The same call as `queryAction` (allowlist, client, `edgeCache` strip, Redis), answered as the SDK returned it: augur-api's `BaseResponse<T>` envelope (every SDK method's result) with `data`, `total`, `totalResults` and `count`, so client code can page a list (atlas#107). A method path carries no type, so the caller names `T` (`queryActionRaw<Article[]>(…)`). A `queryAction` and a `queryActionRaw` of one call share one Redis entry. |
118
+ | `queryActionRawWith` | function | `queryActionRaw`, bounded: the same options as {@link queryActionWith}. |
119
+ | `queryActionWith` | function | `queryAction`, bounded (atlas#106): `options.deadline` caps the whole call in milliseconds (every retry and the waits between them), and `options.signal` lets the caller cancel it. At the deadline the call rejects with a `TimeoutError` (the request is cancelled, nothing more is retried, nothing is cached), so a server render can fall back to a client-side fetch. |
118
120
  | `resetSessionImports` | function | Reset lazy-loaded imports. Used in tests only. @internal |
119
121
  | `resolveMethod` | function | Resolve a dot-separated method path on an object, returning the leaf function. |
120
122
  | `unwrapBaseResponse` | value | |
@@ -127,6 +129,31 @@
127
129
  |--------|------|-------------|
128
130
  | `createAugurApiHandler` | function | Creates a Next.js Route Handler that routes method calls through queryAction, or through queryActionRaw when the body has `raw: true` (augur-core's `createFetchQueryActionRaw`). |
129
131
 
132
+ ## `@simpleapps-com/augur-server/sitemap`
133
+
134
+ ### Values
135
+
136
+ | Export | Kind | Description |
137
+ |--------|------|-------------|
138
+ | `buildSitemapIndexXml` | function | The item index: a `<sitemapindex>` of `{base}sitemap-1.xml` … `{base}sitemap-{count}.xml`. |
139
+ | `buildUrlsetXml` | function | An item page: a `<urlset>` of the rows under the items' folder, in order. |
140
+ | `createItemSitemapHandler` | function | An item page's Route Handler, for `app/items/sitemap.xml/[page]/route.ts`, which `sitemapRewrite` maps `{base}sitemap-{n}.xml` onto: a `<urlset>` of page n's items under `base`, a 404 for no such page, or a 503 when Augur can't be read. |
141
+ | `createSitemapIndexHandler` | function | The item index's Route Handler, for `app/items/sitemap.xml/route.ts` (or the folder `base` names): a `<sitemapindex>` of every item page file, or a 503 when Augur can't be read. |
142
+ | `DEFAULT_SITEMAP_BASE` | const | The items' folder when a site names none. |
143
+ | `DEFAULT_SITEMAP_DEADLINE` | const | How long one Augur call may take, in milliseconds: crawlers wait longer than page visitors, and a call past it is a 503 the crawler retries. |
144
+ | `inScope` | function | Whether a link is under the items' folder (the location rule); an empty link never is. |
145
+ | `isSitemapPath` | function | Whether a path is one of the item sitemaps (the index or a page file), which a site's proxy MUST pass through before any item-URL redirect (the proxy runs before rewrites). |
146
+ | `itemSitemapCount` | function | How many 5,000-item sitemaps cover `total` items (the endpoint fixes a page at 5,000). |
147
+ | `itemSitemapUrl` | function | Item sitemap n's URL: `{siteUrl}{base}sitemap-{n}.xml`. |
148
+ | `parseItemSitemapPage` | function | The page a request names (the rewrite's bare `:page`): its value when it is a canonical natural number, else 0, "not a page" (`0`, `01`, `1e3`, ` 1`, `-1` and text never name one). |
149
+ | `robotsSitemaps` | function | robots.txt's sitemaps: the site's own root `/sitemap.xml` and the item index. Two lines, since the specs name no index inside an index. |
150
+ | `sitemapBase` | function | The items' folder as a path, with one leading and one trailing "/" ("items" → "/items/"). |
151
+ | `sitemapRewrite` | function | The Next.js rewrite from `{base}sitemap-{n}.xml` to the item page handler's route; spread it into `next.config`'s `rewrites()`. |
152
+
153
+ ### Types
154
+
155
+ `SitemapOptions`, `SitemapOutcome`, `SitemapRewrite`, `SitemapRow`, `SitemapSite`
156
+
130
157
  ## `@simpleapps-com/augur-server/next-auth`
131
158
 
132
159
  No exports.
package/README.md CHANGED
@@ -15,29 +15,57 @@ version; nothing requires them to share one.
15
15
  pnpm add @simpleapps-com/augur-server
16
16
  ```
17
17
 
18
- | Import | Purpose |
19
- | ------------------------------------------- | -------------------------------------------------------- |
20
- | `@simpleapps-com/augur-server` | Site actions, caching, `safeAction`, environment, Redis |
21
- | `@simpleapps-com/augur-server/site` | `createServerSite` |
22
- | `@simpleapps-com/augur-server/hooks` | `createServerQueryProxy` (registers `queryAction`) |
23
- | `@simpleapps-com/augur-server/query-action` | `queryAction`, `queryActionRaw`, `getSessionCredentials` |
24
- | `@simpleapps-com/augur-server/api` | `createAugurApiHandler` (fetch mode) |
25
- | `@simpleapps-com/augur-server/auth` | `createAuthConfig` |
26
- | `@simpleapps-com/augur-server/query` | `createQueryOptions`, `createSuspenseQueryOptions` |
27
- | `@simpleapps-com/augur-server/actions` | Types only |
28
- | `@simpleapps-com/augur-server/testing` | `createMockSiteActions`, `createMockClient` |
29
- | `@simpleapps-com/augur-server/next-auth` | NextAuth type augmentations |
18
+ | Import | Purpose |
19
+ | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
20
+ | `@simpleapps-com/augur-server` | Site actions, caching, `safeAction`, environment, Redis |
21
+ | `@simpleapps-com/augur-server/site` | `createServerSite` |
22
+ | `@simpleapps-com/augur-server/hooks` | `createServerQueryProxy` (registers `queryAction`) |
23
+ | `@simpleapps-com/augur-server/query-action` | `queryAction`, `queryActionRaw`, `queryActionWith`, `queryActionRawWith` (bounded by a deadline or signal, atlas#106), `getSessionCredentials` |
24
+ | `@simpleapps-com/augur-server/api` | `createAugurApiHandler` (fetch mode) |
25
+ | `@simpleapps-com/augur-server/sitemap` | `createSitemapIndexHandler`, `createItemSitemapHandler`, `sitemapRewrite`, `robotsSitemaps`, `isSitemapPath` (item sitemaps, atlas#101) |
26
+ | `@simpleapps-com/augur-server/auth` | `createAuthConfig` |
27
+ | `@simpleapps-com/augur-server/query` | `createQueryOptions`, `createSuspenseQueryOptions` |
28
+ | `@simpleapps-com/augur-server/actions` | Types only |
29
+ | `@simpleapps-com/augur-server/testing` | `createMockSiteActions`, `createMockClient` |
30
+ | `@simpleapps-com/augur-server/next-auth` | NextAuth type augmentations |
30
31
 
31
32
  **Cross-site sessions** (a site signing users in for other sites, augur-support's pattern) need
32
33
  `createServerSite(client, { auth: { crossSite: true } })`. Without it, sign-in ignores the
33
34
  target `siteId` and `queryAction` never reads the session cookie, so pages that prefetch through
34
35
  it can render statically (atlas#105). A multi-tenant site MUST set it.
35
36
 
37
+ **Bounded calls** (atlas#106): a server render that awaits a read SHOULD bound it with
38
+ `queryActionWith({ deadline: 5000 }, methodPath, ...args)` (or `queryActionRawWith`). With no
39
+ bound, the SDK's retry budget (3 retries at 30 s each, plus backoff) becomes page latency. At
40
+ the deadline the call rejects with a `TimeoutError`: the request is cancelled, nothing more is
41
+ retried and nothing is cached, so the page can fall back to a client-side fetch. `options.signal`
42
+ cancels it too (server code only: a signal can't cross a server action from the browser). The
43
+ options never enter the cache key. It needs an `@simpleapps-com/augur-api` with
44
+ `AugurAPI.withRequest`; on an older client the call is refused rather than run unbounded.
45
+
46
+ **Reads** (atlas#102): every site-action read follows a read spec (`src/actions/read-specs.ts`).
47
+
48
+ - **Paging:** a read that returns every row pages 100 rows a call until an empty page, at most 50 calls, and returns `{ data, total, capReached }` (so `getWishlistDetail` no longer returns a bare array). `capReached` is true when the cap stopped it: the result may be incomplete.
49
+ - **User data** (`items.itemWishlist`, `items.itemFavorites`) is never cached on the server. In the browser it is cached for a minute and cleared by the user's own writes (augur-hooks `userWriteClearing`).
50
+ - **P21 data** (`customers.customer`, `joomla.users`, `orders.oeHdr`, `vmi`) stays in Redis for a minute and is never cached at the edge.
51
+ - **Guide:** https://augur.build/docs/packages/augur-server.
52
+
53
+ **Item sitemaps** (atlas#101) are built per request from `googMc.sitemaps.items.list`.
54
+
55
+ - **Layout:** the item index is `{base}sitemap.xml` and page n is `{base}sitemap-{n}.xml` (5,000 items each). `base` defaults to `/items/`.
56
+ - **Routes:** `app/items/sitemap.xml/route.ts` and `app/items/sitemap.xml/[page]/route.ts`, plus `sitemapRewrite()` in `next.config`.
57
+ - **`base`** MUST match the item links Augur returns: the protocol lets a sitemap list only URLs under its own folder, and a link outside it is left out.
58
+ - **robots.txt** names the site's root `/sitemap.xml` and the item index (`robotsSitemaps`). The root sitemap stays the site's own.
59
+ - **Item-URL proxies** MUST let `isSitemapPath(pathname)` through before any item-URL redirect.
60
+ - **Failures:** Augur failing or taking longer than `deadline` (10 s by default) answers 503 with `Retry-After`, uncached.
61
+ - **Guide:** https://augur.build/docs/packages/augur-server#item-sitemaps.
62
+
36
63
  ## Development
37
64
 
38
65
  TypeScript in `src/`, built to `dist/` (ESM) by tsup with `"use server"` and `"use client"`
39
- banners per entry. The decisions are proved (`src/rules.ts`, `src/scoped-client-key.ts`; model
40
- `models/AugurServer.dfy`, links `models/links/augur-server-*.dfy`); the rest is tested at 100%.
66
+ banners per entry. The decisions are proved (`src/rules.ts`, `src/scoped-client-key.ts`, `src/sitemap-rules.ts`;
67
+ models `models/AugurServer.dfy`, `models/AugurServerSitemap.dfy`, links
68
+ `models/links/augur-server-*.dfy`); the rest is tested at 100%.
41
69
 
42
70
  ```bash
43
71
  pnpm -C repo/packages/augur-server test
@@ -0,0 +1,99 @@
1
+ /** A category child's display order, and where it sits in the list it came from. */
2
+ export interface SeqEntry {
3
+ seqNo: number;
4
+ index: number;
5
+ }
6
+ /**
7
+ * The entries from `k` on, in display order (an insertion sort, stable).
8
+ *
9
+ * @ensures every entry kept — exactly the model's SortBySeq in the link (sorted, same multiset)
10
+ */
11
+ export declare function sortBySeqFrom(xs: SeqEntry[], k: number): SeqEntry[];
12
+ /** The category's children as shown: in display order, or as given when sorting is off. */
13
+ export declare function categoryChildren(sortChildren: boolean, xs: SeqEntry[]): SeqEntry[];
14
+ /** The first value given: the call's when present, else the fallback. */
15
+ export declare function firstGiven(given: number | undefined, fallback: number | undefined): number | undefined;
16
+ /**
17
+ * A text given, else the fallback (`given ?? fallback`): each category param is the filters'
18
+ * value or its default (model `CategoryParamsByField`).
19
+ *
20
+ * @ensures exactly the model's TextOr
21
+ */
22
+ export declare function textOr(given: string | undefined, fallback: string): string;
23
+ /** getCategoryItems' argument: typed items filters, a raw object with a text sortBy, or raw. */
24
+ export type CategoryArgKind = "typedFilters" | "rawPrefixed" | "rawAsGiven";
25
+ /**
26
+ * Which argument getCategoryItems was given: typed filters (their `filters` an array), else a raw
27
+ * params object, sent with the prefix on its sortBy when that is text, else as given.
28
+ *
29
+ * @ensures exactly the model's CategoryArgKindOf
30
+ */
31
+ export declare function categoryArgKind(filtersIsArray: boolean, sortByIsString: boolean): CategoryArgKind;
32
+ /** getCategoryItemsInfinite: a missing or NaN limit is none. */
33
+ export declare function givenLimit(given: number | undefined, isNan: boolean): number | undefined;
34
+ /** `total || 0`: a missing or NaN total is 0. */
35
+ export declare function totalOrZero(total: number | undefined, isNan: boolean): number;
36
+ /** getInvMastDoc's item id: upper-cased (ASCII, utils' rule) and trimmed. */
37
+ export declare function docItemId(itemId: string): string;
38
+ /**
39
+ * The item id getInvMastDoc sends: an itemId is always upper-case in this system (owner
40
+ * 2026-11-10), so a taken one (positional at uid 0, or any in a params object) is sent as
41
+ * `docItemId` gives it, never as given; else none.
42
+ *
43
+ * @ensures exactly the model's SentItemId
44
+ */
45
+ export declare function sentItemId(itemId: string | undefined, taken: boolean): string | undefined;
46
+ /** batchGetInvMastDocs' key: the item id when given, else the uid as decimal text. */
47
+ export declare function docBatchKey(itemId: string | undefined, uid: number): string;
48
+ /** cartHdrLookup goes ahead only with both a contact and a customer (from the call or config). */
49
+ export declare function cartIdsPresent(hasContact: boolean, hasCustomer: boolean): boolean;
50
+ /** `Number(userId) || 0`: NaN is the anonymous cart (0). */
51
+ export declare function cartUserId(n: number, isNan: boolean): number;
52
+ /** A line's unit of measure: the site's conversion when it has one, else as given. */
53
+ export declare function lineUom(converted: string | undefined, uom: string): string;
54
+ /** getJoomlaContent reads by alias when one is given. */
55
+ export declare function contentByAlias(alias: string): boolean;
56
+ /** The category id is sent only when truthy: 0 and missing are dropped. */
57
+ export declare function catIdParam(catId: number | undefined): number | undefined;
58
+ /** A menu item's parent, and where it sits in the list it came from. */
59
+ export interface ParentEntry {
60
+ parentId: number;
61
+ index: number;
62
+ }
63
+ /**
64
+ * The items from `k` on whose parent is `parentId`, in order.
65
+ *
66
+ * @ensures each kept item's parent is parentId — exactly the model's DirectChildren in the link
67
+ */
68
+ export declare function directChildrenFrom(items: ParentEntry[], parentId: number, k: number): ParentEntry[];
69
+ /**
70
+ * The group titles from `k` on that are not empty, in order (the profile's permissions).
71
+ *
72
+ * @ensures every title kept is non-empty — exactly the model's NonEmptyTitles in the link
73
+ */
74
+ export declare function nonEmptyTitlesFrom(titles: string[], k: number): string[];
75
+ /** The profile's id: the user id as decimal text. */
76
+ export declare function profileId(id: number): string;
77
+ /** addFavorite sends the one item as a list. */
78
+ export declare function oneUid(uid: number): number[];
79
+ /** The site's cache prefix: its siteId scoped, or none without one. */
80
+ export declare function sitePrefix(siteId: string): string;
81
+ /**
82
+ * Which cache values a service's factory gets: none (commerce), the prefix alone, the short
83
+ * bundle, the short and long bundle, or the long values alone (agr-site).
84
+ */
85
+ export type Bundle = "noCacheConfig" | "prefixOnly" | "shortBundle" | "longBundle" | "longOnly";
86
+ /** The bundle for a service, by its name in `site.actions`. */
87
+ export declare function bundleOf(service: string): Bundle;
88
+ /** Where the hybrid proxy sends a property: nothing, the memo, a legacy service, the SDK mirror. */
89
+ export type Route = "noRoute" | "memo" | "legacy" | "fallback";
90
+ /** The service-level route: a symbol is nothing, a memo hit the memo, an own service legacy. */
91
+ export declare function serviceRoute(isSymbol: boolean, memoHit: boolean, hasOwn: boolean): Route;
92
+ /** The method-level route inside a legacy service: its own method first, else the mirror's. */
93
+ export declare function methodRoute(isSymbol: boolean, inService: boolean): Route;
94
+ /**
95
+ * wrapCall caches a read only on a tier with a Redis TTL above 0 (`hasTtl` the tier has one, `ttl`
96
+ * its value or 0: lsc can't narrow an optional inside `&&`, models/LSC-GAPS.md).
97
+ */
98
+ export declare function wrapCaches(isRead: boolean, hasTtl: boolean, ttl: number): boolean;
99
+ //# sourceMappingURL=action-rules.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"action-rules.d.ts","sourceRoot":"","sources":["../../src/actions/action-rules.ts"],"names":[],"mappings":"AAYA,oFAAoF;AACpF,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAqBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE,CAQnE;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAKlF;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED,gGAAgG;AAChG,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,aAAa,GAAG,YAAY,CAAC;AAE5E;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,GAAG,eAAe,CAOjG;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAKxF;AAED,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAM7E;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMzF;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAO3E;AAID,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAIjF;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAK5D;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK1E;AAID,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIrD;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMxE;AAED,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAAE,EACpB,QAAQ,EAAE,MAAM,EAChB,CAAC,EAAE,MAAM,GACR,WAAW,EAAE,CAUf;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAUxE;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAM5C;AAID,gDAAgD;AAChD,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAI5C;AAID,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,eAAe,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,GAAG,UAAU,CAAC;AA4BhG,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAWhD;AAED,oGAAoG;AACpG,MAAM,MAAM,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/D,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK,CAUxF;AAED,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,KAAK,CAQxE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAIjF"}
@@ -1,26 +1,18 @@
1
1
  import type { AgrSiteTypes, AugurAPI } from "@simpleapps-com/augur-api";
2
- import type { Seconds } from "../duration";
3
- import type { EdgeCacheValue, ListResult } from "../sdk-call";
2
+ import { type AllRows, type SpecReadConfig } from "../cache/spec-read";
4
3
  /** Derived from augur-api SDK — keeps types in sync automatically. */
5
4
  export type AgrSiteApiClient = Pick<AugurAPI, "agrSite">;
6
- export interface AgrSiteActionsConfig {
7
- /** Cache key prefix (e.g. "example:"). Default: "". */
8
- cachePrefix?: string;
9
- /** CDN edge cache value for rarely-changing data. Default: 8 (hours). */
10
- longEdgeCache?: EdgeCacheValue;
11
- /** Redis TTL for rarely-changing data in seconds. Default: 28800 (8 hours). */
12
- longRedisTtl?: Seconds;
13
- }
5
+ /** Cache values: both reads use the long pair (`longEdgeCache`, `longRedisTtl`). */
6
+ export type AgrSiteActionsConfig = SpecReadConfig;
14
7
  export interface AgrSiteActions {
15
- getSettings: (serviceName: string) => Promise<ListResult>;
8
+ /** Every setting of the service (paged to the end). */
9
+ getSettings: (serviceName: string) => Promise<AllRows>;
16
10
  /** The site's generated robots.txt (`{ content, contentType }`). Replaces `getMetaFiles`. */
17
11
  getRobots: () => Promise<AgrSiteTypes.MetaFilesRobotsListData>;
18
12
  }
19
13
  /**
20
- * Creates server-side AGR Site actions with Redis caching and edge cache support.
21
- *
22
- * Covers the AGR Site microservice settings and robots.txt endpoints. Uses long
23
- * TTLs since site settings and meta files rarely change.
14
+ * Creates server-side AGR Site actions: settings and robots.txt, on the long tier since they
15
+ * rarely change. Each read is a spec (`read-specs.ts`).
24
16
  *
25
17
  * @example
26
18
  * ```ts
@@ -1 +1 @@
1
- {"version":3,"file":"agr-site.d.ts","sourceRoot":"","sources":["../../src/actions/agr-site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAExE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9D,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1D,6FAA6F;IAC7F,SAAS,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;CAChE;AAED;;;;;;;;;;;;;;;;;SAiBS;AACT,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,gBAAgB,EACrB,MAAM,GAAE,oBAAyB,GAChC,cAAc,CA8BhB"}
1
+ {"version":3,"file":"agr-site.d.ts","sourceRoot":"","sources":["../../src/actions/agr-site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAA+B,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpG,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEzD,oFAAoF;AACpF,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,6FAA6F;IAC7F,SAAS,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;CAChE;AAED;;;;;;;;;;;;;;;SAeS;AACT,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,gBAAgB,EACrB,MAAM,GAAE,oBAAyB,GAChC,cAAc,CAqBhB"}
@@ -1 +1 @@
1
- {"version":3,"file":"commerce.d.ts","sourceRoot":"","sources":["../../src/actions/commerce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,CAAC,MAAM,EAAE;QACtB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KAC9B,KAAK,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC;IAEnC,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IAErE,SAAS,EAAE,CACT,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;KACvB,EAAE,KACA,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtB,eAAe,EAAE,CACf,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;KACvB,EAAE,KACA,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtB,eAAe,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,iBAAiB,EAAE,CACjB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAElE,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CAChG;AAED;;;;;;;;;;;;;;;;;;;;SAoBS;AACT,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,iBAAiB,EACtB,MAAM,GAAE,qBAA0B,GACjC,eAAe,CAkGjB"}
1
+ {"version":3,"file":"commerce.d.ts","sourceRoot":"","sources":["../../src/actions/commerce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9C,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,CAAC,MAAM,EAAE;QACtB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KAC9B,KAAK,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC;IAEnC,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IAErE,SAAS,EAAE,CACT,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;KACvB,EAAE,KACA,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtB,eAAe,EAAE,CACf,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;KACvB,EAAE,KACA,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtB,eAAe,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,iBAAiB,EAAE,CACjB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAElE,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CAChG;AAED;;;;;;;;;;;;;;;;;;;;SAoBS;AACT,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,iBAAiB,EACtB,MAAM,GAAE,qBAA0B,GACjC,eAAe,CAuGjB"}
@@ -1,17 +1,15 @@
1
1
  import type { AugurAPI, CustomersTypes } from "@simpleapps-com/augur-api";
2
- import type { Seconds } from "../duration";
3
2
  import type { CustomerDocument } from "@simpleapps-com/augur-utils";
4
- import type { EdgeCacheValue, ListResult } from "../sdk-call";
3
+ import type { ListResult } from "../sdk-call";
4
+ import { type AllRows, type SpecReadConfig } from "../cache/spec-read";
5
5
  /** Derived from augur-api SDK — keeps types in sync automatically. */
6
6
  export type CustomersApiClient = Pick<AugurAPI, "customers">;
7
- export interface CustomersActionsConfig {
8
- /** Cache key prefix (e.g. "example:"). Default: "". */
9
- cachePrefix?: string;
10
- /** CDN edge cache value passed to SDK. Default: 1 (hour). */
11
- edgeCache?: EdgeCacheValue;
12
- /** Redis TTL in seconds. Default: 3600 (1 hour). */
13
- redisTtl?: Seconds;
14
- }
7
+ /**
8
+ * Cache values. A customer's records are a user path (augur-core `USER_PATHS`, atlas#102): they
9
+ * change in P21, so the server never caches them, whatever these say; the browser keeps a short
10
+ * cache.
11
+ */
12
+ export type CustomersActionsConfig = SpecReadConfig;
15
13
  export interface CustomersActions {
16
14
  customerLookup: (params: CustomersTypes.CustomerLookupGetParams) => Promise<ListResult<CustomersTypes.CustomerLookupGetItem>>;
17
15
  getCustomerDoc: (customerId: number) => Promise<CustomerDocument>;
@@ -21,13 +19,12 @@ export interface CustomersActions {
21
19
  getCustomerInvoiceDetail: (customerId: number, invoiceNo: number) => Promise<unknown>;
22
20
  getCustomerQuotes: (customerId: number, params?: Record<string, unknown>) => Promise<ListResult>;
23
21
  getCustomerQuoteDetail: (customerId: number, quoteNo: number) => Promise<unknown>;
24
- getShipToAddresses: (customerId: number) => Promise<ListResult>;
22
+ /** Every ship-to address (paged to the end), and whether the page cap stopped the read. */
23
+ getShipToAddresses: (customerId: number) => Promise<AllRows>;
25
24
  }
26
25
  /**
27
- * Creates server-side customer actions with Redis caching and edge cache support.
28
- *
29
- * Covers the customers microservice endpoints used by ecommerce sites:
30
- * customer lookup, doc, orders, invoices, quotes, and ship-to addresses.
26
+ * Creates server-side customer actions: customer lookup, doc, orders, invoices, quotes and
27
+ * ship-to addresses. Each read is a spec (`read-specs.ts`); none is cached on the server.
31
28
  *
32
29
  * @example
33
30
  * ```ts
@@ -1 +1 @@
1
- {"version":3,"file":"customers.d.ts","sourceRoot":"","sources":["../../src/actions/customers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9D,sEAAsE;AACtE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAE7D,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,CACd,MAAM,EAAE,cAAc,CAAC,uBAAuB,KAC3C,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC/D,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClE,iBAAiB,EAAE,CACjB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,cAAc,CAAC,wBAAwB,KAC7C,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,sBAAsB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,mBAAmB,EAAE,CACnB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,cAAc,CAAC,0BAA0B,KAC/C,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,wBAAwB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtF,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACjG,sBAAsB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACjE;AAED;;;;;;;;;;;;;;;;;SAiBS;AACT,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,kBAAkB,EACvB,MAAM,GAAE,sBAA2B,GAClC,gBAAgB,CA0KlB"}
1
+ {"version":3,"file":"customers.d.ts","sourceRoot":"","sources":["../../src/actions/customers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAa5B,sEAAsE;AACtE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,CACd,MAAM,EAAE,cAAc,CAAC,uBAAuB,KAC3C,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC/D,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClE,iBAAiB,EAAE,CACjB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,cAAc,CAAC,wBAAwB,KAC7C,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,sBAAsB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,mBAAmB,EAAE,CACnB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,cAAc,CAAC,0BAA0B,KAC/C,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,wBAAwB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtF,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACjG,sBAAsB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,2FAA2F;IAC3F,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D;AAED;;;;;;;;;;;;;;;SAeS;AACT,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,kBAAkB,EACvB,MAAM,GAAE,sBAA2B,GAClC,gBAAgB,CA2HlB"}
@@ -1,21 +1,18 @@
1
1
  import type { AugurAPI } from "@simpleapps-com/augur-api";
2
- import type { Seconds } from "../duration";
3
- import type { EdgeCacheValue, ListResult } from "../sdk-call";
2
+ import { type AllRows, type SpecReadConfig } from "../cache/spec-read";
4
3
  /** Derived from augur-api SDK — keeps types in sync automatically. */
5
4
  export type FavoritesApiClient = Pick<AugurAPI, "items">;
6
- export interface FavoritesActionsConfig {
7
- /** Cache key prefix (e.g. "example:"). Default: "". */
8
- cachePrefix?: string;
9
- /** CDN edge cache value passed to SDK. Default: 1 (hour). */
10
- edgeCache?: EdgeCacheValue;
11
- /** Redis TTL in seconds. Default: 3600 (1 hour). */
12
- redisTtl?: Seconds;
13
- }
5
+ /**
6
+ * Cache values. Favorites are a user path (augur-core `USER_PATHS`, atlas#102): the server never
7
+ * caches them, whatever these say; the browser keeps a short cache its own writes clear.
8
+ */
9
+ export type FavoritesActionsConfig = SpecReadConfig;
14
10
  export interface FavoritesActions {
15
- getFavorites: (userId: number) => Promise<ListResult>;
11
+ /** Every favorite of the user (paged to the end), and whether the page cap stopped the read. */
12
+ getFavorites: (userId: number) => Promise<AllRows>;
16
13
  addFavorite: (userId: number, invMastUid: number) => Promise<unknown>;
17
14
  removeFavorite: (userId: number, invMastUid: number) => Promise<void>;
18
15
  }
19
- /** Creates server-side favorites actions with Redis caching and edge cache support. */
16
+ /** Creates server-side favorites actions: the read pages to the end and is never cached. */
20
17
  export declare function createFavoritesActions(api: FavoritesApiClient, config?: FavoritesActionsConfig): FavoritesActions;
21
18
  //# sourceMappingURL=favorites.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"favorites.d.ts","sourceRoot":"","sources":["../../src/actions/favorites.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9D,sEAAsE;AACtE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACtD,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,uFAAuF;AACvF,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,kBAAkB,EACvB,MAAM,GAAE,sBAA2B,GAClC,gBAAgB,CA4BlB"}
1
+ {"version":3,"file":"favorites.d.ts","sourceRoot":"","sources":["../../src/actions/favorites.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAuB,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAI5F,sEAAsE;AACtE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,gGAAgG;IAChG,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,4FAA4F;AAC5F,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,kBAAkB,EACvB,MAAM,GAAE,sBAA2B,GAClC,gBAAgB,CAelB"}
@@ -1,24 +1,16 @@
1
1
  import type { AugurAPI } from "@simpleapps-com/augur-api";
2
- import type { Seconds } from "../duration";
3
- import type { EdgeCacheValue, ListResult } from "../sdk-call";
2
+ import { type AllRows, type SpecReadConfig } from "../cache/spec-read";
4
3
  /** Derived from augur-api SDK — keeps types in sync automatically. */
5
4
  export type GregorovichApiClient = Pick<AugurAPI, "gregorovich">;
6
- export interface GregorovichActionsConfig {
7
- /** Cache key prefix (e.g. "example:"). Default: "". */
8
- cachePrefix?: string;
9
- /** CDN edge cache value passed to SDK. Default: 1 (hour). */
10
- edgeCache?: EdgeCacheValue;
11
- /** Redis TTL in seconds. Default: 3600 (1 hour). */
12
- redisTtl?: Seconds;
13
- }
5
+ /** Cache values: the short Redis TTL; no edge value is sent (today's behaviour). */
6
+ export type GregorovichActionsConfig = SpecReadConfig;
14
7
  export interface GregorovichActions {
15
- getDocuments: (params?: Record<string, unknown>) => Promise<ListResult>;
8
+ /** Every document (paged to the end), and whether the page cap stopped the read. */
9
+ getDocuments: (params?: Record<string, unknown>) => Promise<AllRows>;
16
10
  }
17
11
  /**
18
- * Creates server-side gregorovich actions with Redis caching and edge cache support.
19
- *
20
- * Covers the Gregorovich service's document listing, the only endpoint the SDK
21
- * exposes since augur-api 2026.10.8.
12
+ * Creates server-side gregorovich actions: the Gregorovich service's document listing, the only
13
+ * endpoint the SDK exposes since augur-api 2026.10.8. The read is a spec (`read-specs.ts`).
22
14
  *
23
15
  * @example
24
16
  * ```ts
@@ -1 +1 @@
1
- {"version":3,"file":"gregorovich.d.ts","sourceRoot":"","sources":["../../src/actions/gregorovich.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9D,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AAEjE,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACzE;AAED;;;;;;;;;;;;;;;;SAgBS;AACT,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,oBAAoB,EACzB,MAAM,GAAE,wBAA6B,GACpC,kBAAkB,CAqBpB"}
1
+ {"version":3,"file":"gregorovich.d.ts","sourceRoot":"","sources":["../../src/actions/gregorovich.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAuB,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG5F,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AAEjE,oFAAoF;AACpF,MAAM,MAAM,wBAAwB,GAAG,cAAc,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACtE;AAED;;;;;;;;;;;;;;SAcS;AACT,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,oBAAoB,EACzB,MAAM,GAAE,wBAA6B,GACpC,kBAAkB,CAcpB"}
@@ -1,22 +1,12 @@
1
1
  import type { AugurAPI } from "@simpleapps-com/augur-api";
2
- import type { Seconds } from "../duration";
3
2
  import type { GetItemCategoryApiOptions } from "@simpleapps-com/augur-hooks";
4
- import type { EdgeCacheValue, ListResult } from "../sdk-call";
3
+ import type { ListResult } from "../sdk-call";
5
4
  import type { TAttribute, TCategory, TCategoryItemsResult, TInvMast, TInvMastDoc, TItemAccessory, TItemsFilters, TProductItem, TStock } from "@simpleapps-com/augur-utils";
5
+ import { type AllRows, type SpecReadConfig } from "../cache/spec-read";
6
6
  import type { PaginatedResult } from "../pagination";
7
7
  /** Derived from augur-api SDK — keeps types in sync automatically. */
8
8
  export type ItemsApiClient = Pick<AugurAPI, "items">;
9
- export interface ItemActionsConfig {
10
- /** Cache key prefix (e.g. "example:"). Default: "". */
11
- cachePrefix?: string;
12
- /** CDN edge cache value for most calls. Default: 1 (hour). */
13
- edgeCache?: EdgeCacheValue;
14
- /** CDN edge cache for rarely-changing data like FAQs. Default: 8 (hours). */
15
- longEdgeCache?: EdgeCacheValue;
16
- /** Redis TTL for most calls in seconds. Default: 3600 (1 hour). */
17
- redisTtl?: Seconds;
18
- /** Redis TTL for rarely-changing data in seconds. Default: 28800 (8 hours). */
19
- longRedisTtl?: Seconds;
9
+ export interface ItemActionsConfig extends SpecReadConfig {
20
10
  /** Sort category children by sequenceNo. Default: true. */
21
11
  sortChildren?: boolean;
22
12
  /** Prefix prepended to sortBy filter values (e.g. "item_category_sequence_no_min|"). */
@@ -46,9 +36,9 @@ export interface ItemActions {
46
36
  };
47
37
  getStock: (invMastUid: number) => Promise<TStock>;
48
38
  getStockCompanySummary: (invMastUid: number) => Promise<Record<string, number>>;
49
- getItemFaqs: (invMastUid: number) => Promise<ListResult>;
50
- getItemSubstitutes: (invMastUid: number) => Promise<ListResult>;
51
- getItemAccessories: (invMastUid: number) => Promise<ListResult<TItemAccessory>>;
39
+ getItemFaqs: (invMastUid: number) => Promise<AllRows>;
40
+ getItemSubstitutes: (invMastUid: number) => Promise<AllRows>;
41
+ getItemAccessories: (invMastUid: number) => Promise<AllRows<TItemAccessory>>;
52
42
  getSimilarItems: (invMastUid: number) => Promise<ListResult>;
53
43
  batchGetInvMastDocs: (params: {
54
44
  invMastUid?: number;
@@ -57,10 +47,8 @@ export interface ItemActions {
57
47
  batchGetStockData: (invMastUids: number[]) => Promise<Record<number, TStock>>;
58
48
  }
59
49
  /**
60
- * Creates server-side item actions with Redis caching and edge cache support.
61
- *
62
- * Uses `withServerCache` which produces cache keys compatible with augur-hooks'
63
- * `withCache`, so server-prefetched data is shared with client-side hooks.
50
+ * Creates server-side item actions. Each read is a spec (`read-specs.ts`); the decisions are the
51
+ * proved `action-rules.ts`.
64
52
  *
65
53
  * @example
66
54
  * ```ts
@@ -1 +1 @@
1
- {"version":3,"file":"items.d.ts","sourceRoot":"","sources":["../../src/actions/items.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"items.d.ts","sourceRoot":"","sources":["../../src/actions/items.ts"],"names":[],"mappings":"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"}
@@ -1,17 +1,14 @@
1
1
  import type { AugurAPI } from "@simpleapps-com/augur-api";
2
- import type { Seconds } from "../duration";
3
2
  import type { MenuItem, TJoomlaContent, TMenu, TPasswordVerification } from "@simpleapps-com/augur-utils";
4
- import type { EdgeCacheValue, ListResult } from "../sdk-call";
3
+ import type { ListResult } from "../sdk-call";
4
+ import { type SpecReadConfig } from "../cache/spec-read";
5
5
  /** Derived from augur-api SDK — keeps types in sync automatically. */
6
6
  export type JoomlaApiClient = Pick<AugurAPI, "joomla">;
7
- export interface JoomlaActionsConfig {
8
- /** Cache key prefix (e.g. "example:"). Default: "". */
9
- cachePrefix?: string;
10
- /** CDN edge cache value passed to SDK. Default: 1 (hour). */
11
- edgeCache?: EdgeCacheValue;
12
- /** Redis TTL for Joomla lookups in seconds. Default: 3600 (1 hour). */
13
- redisTtl?: Seconds;
14
- }
7
+ /**
8
+ * Cache values. A user's profile is a user path (augur-core `USER_PATHS`, atlas#102): the server
9
+ * never caches it, whatever these say.
10
+ */
11
+ export type JoomlaActionsConfig = SpecReadConfig;
15
12
  export interface NormalizedUserProfile {
16
13
  id: string;
17
14
  name: string;
@@ -37,10 +34,7 @@ export interface JoomlaActions {
37
34
  verifyPassword: (username: string, password: string) => Promise<TPasswordVerification>;
38
35
  }
39
36
  /**
40
- * Creates server-side Joomla content actions with Redis caching and edge cache support.
41
- *
42
- * Uses `withServerCache` which produces cache keys compatible with augur-hooks'
43
- * `withCache`, so server-prefetched data is shared with client-side hooks.
37
+ * Creates server-side Joomla content actions. Each read is a spec (`read-specs.ts`).
44
38
  *
45
39
  * @example
46
40
  * ```ts
@@ -1 +1 @@
1
- {"version":3,"file":"joomla.d.ts","sourceRoot":"","sources":["../../src/actions/joomla.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,KAAK,EACL,qBAAqB,EAEtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9D,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE;QAChB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;QAC7C,CACE,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,GACzC,OAAO,CAAC,cAAc,CAAC,CAAC;KAC5B,CAAC;IACF,oBAAoB,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;IAChG,aAAa,EAAE;QACb,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;KAClE,CAAC;IACF,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjE,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC5E,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACxF;AAED;;;;;;;;;;;;;;;;;;;SAmBS;AACT,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,eAAe,EACpB,MAAM,GAAE,mBAAwB,GAC/B,aAAa,CAoKf"}
1
+ {"version":3,"file":"joomla.d.ts","sourceRoot":"","sources":["../../src/actions/joomla.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,KAAK,EACL,qBAAqB,EAEtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAiB5B,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE;QAChB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;QAC7C,CACE,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,GACzC,OAAO,CAAC,cAAc,CAAC,CAAC;KAC5B,CAAC;IACF,oBAAoB,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;IAChG,aAAa,EAAE;QACb,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;KAClE,CAAC;IACF,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjE,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC5E,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACxF;AAyBD;;;;;;;;;;;;;;;;SAgBS;AACT,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,eAAe,EACpB,MAAM,GAAE,mBAAwB,GAC/B,aAAa,CAyHf"}
@@ -1,34 +1,24 @@
1
1
  import type { AugurAPI, LegacyTypes } from "@simpleapps-com/augur-api";
2
- import type { Seconds } from "../duration";
3
2
  import type { TWebDesc } from "@simpleapps-com/augur-utils";
4
- import type { EdgeCacheValue, ListResult } from "../sdk-call";
3
+ import type { ListResult } from "../sdk-call";
4
+ import { type AllRows, type SpecReadConfig } from "../cache/spec-read";
5
5
  /** Derived from augur-api SDK — keeps types in sync automatically. */
6
6
  export type LegacyApiClient = Pick<AugurAPI, "legacy">;
7
- export interface LegacyActionsConfig {
8
- /** Cache key prefix (e.g. "example:"). Default: "". */
9
- cachePrefix?: string;
10
- /** CDN edge cache value passed to SDK. Default: 1 (hour). */
11
- edgeCache?: EdgeCacheValue;
12
- /** CDN edge cache for rarely-changing data like states. Default: 8 (hours). */
13
- longEdgeCache?: EdgeCacheValue;
14
- /** Redis TTL in seconds. Default: 3600 (1 hour). */
15
- redisTtl?: Seconds;
16
- /** Redis TTL for rarely-changing data in seconds. Default: 28800 (8 hours). */
17
- longRedisTtl?: Seconds;
18
- }
7
+ /** Cache values: the short pair for item data, the long pair for states. */
8
+ export type LegacyActionsConfig = SpecReadConfig;
19
9
  export interface LegacyActions {
20
10
  getItemWebDesc: (invMastUid: number) => Promise<TWebDesc | undefined>;
21
11
  getAlsoBoughtItems: (invMastUid: number) => Promise<ListResult<LegacyTypes.InvMastAlsoBoughtListItem>>;
22
- getItemTags: (invMastUid: number) => Promise<ListResult>;
12
+ /** Every tag of the item (paged to the end). */
13
+ getItemTags: (invMastUid: number) => Promise<AllRows>;
14
+ /** Every state (paged to the end), or the one with `twoLetterCode`. */
23
15
  getStates: (params?: {
24
16
  twoLetterCode?: string;
25
- }) => Promise<ListResult>;
17
+ }) => Promise<AllRows>;
26
18
  }
27
19
  /**
28
- * Creates server-side legacy actions with Redis caching and edge cache support.
29
- *
30
- * Covers the legacy microservice endpoints used by ecommerce sites:
31
- * webDesc, alsoBought, tags, and states.
20
+ * Creates server-side legacy actions: webDesc, alsoBought, tags and states. Each read is a spec
21
+ * (`read-specs.ts`); tags and states page to the end.
32
22
  *
33
23
  * @example
34
24
  * ```ts
@@ -1 +1 @@
1
- {"version":3,"file":"legacy.d.ts","sourceRoot":"","sources":["../../src/actions/legacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAEvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9D,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,+EAA+E;IAC/E,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;IACtE,kBAAkB,EAAE,CAClB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAChE,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACzD,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACzE;AAED;;;;;;;;;;;;;;;;;SAiBS;AACT,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,eAAe,EACpB,MAAM,GAAE,mBAAwB,GAC/B,aAAa,CA4Ef"}
1
+ {"version":3,"file":"legacy.d.ts","sourceRoot":"","sources":["../../src/actions/legacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAA+B,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpG,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAEvD,4EAA4E;AAC5E,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;IACtE,kBAAkB,EAAE,CAClB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAChE,gDAAgD;IAChD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,uEAAuE;IACvE,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACtE;AAOD;;;;;;;;;;;;;;;SAeS;AACT,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,eAAe,EACpB,MAAM,GAAE,mBAAwB,GAC/B,aAAa,CAiCf"}