@simpleapps-com/augur-server 0.4.3 → 0.5.0

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.
@@ -1,30 +1,87 @@
1
- import { TPriceData, TTaxItem, TTax, TCategory, TAttribute, TInvMast, TInvMastDoc, TStockData, TItemAccessory, TStock, TCartLookUp, TCartLine, TProductItem, TWebDesc, TSmartyStreets } from '@simpleapps-com/augur-utils';
1
+ import { AugurAPI } from '@simpleapps-com/augur-api';
2
+ import { TPriceData, TTaxItem, TTax, TCategory, TAttribute, TInvMast, TInvMastDoc, TStockData, TItemAccessory, TCartLookUp, TCartLine, TProductItem, TWebDesc, TSmartyStreets } from '@simpleapps-com/augur-utils';
2
3
 
3
4
  /**
4
- * The subset of augur-api used by pricing actions.
5
- * Avoids importing the full SDK type so augur-server stays lightweight.
5
+ * Valid CDN edge cache durations accepted by the augur-api SDK.
6
+ *
7
+ * Mirrors `CacheParams['edgeCache']` from `@simpleapps-com/augur-api`
8
+ * (not re-exported from the SDK, so we define it locally).
6
9
  */
7
- interface PricingApiClient {
8
- pricing: {
9
- priceEngine: {
10
- get: (params: Record<string, unknown>) => Promise<{
11
- data: TPriceData;
12
- }>;
13
- };
14
- taxEngine: {
15
- create: (params: Record<string, unknown>) => Promise<{
16
- data: TTax;
17
- }>;
18
- };
19
- };
20
- }
10
+ type EdgeCacheValue = "30s" | "1m" | "5m" | 1 | 2 | 3 | 4 | 5 | 8 | "1" | "2" | "3" | "4" | "5" | "8";
11
+ /**
12
+ * Calls an Augur SDK method, forwarding all arguments with full type safety.
13
+ *
14
+ * With augur-api >= 0.9.6, SDK methods properly declare their `CacheParams`
15
+ * option (including `edgeCache`), so this wrapper preserves both parameter
16
+ * and return-type inference end-to-end.
17
+ *
18
+ * @example
19
+ * ```ts
20
+ * const result = await sdkCall(
21
+ * augurServices.items.invMast.get,
22
+ * invMastUid,
23
+ * { edgeCache: 4 },
24
+ * );
25
+ * ```
26
+ */
27
+ declare function sdkCall<TArgs extends unknown[], TResult>(method: (...args: TArgs) => Promise<TResult>, ...args: TArgs): Promise<TResult>;
28
+ /**
29
+ * Discriminated union for safe action results.
30
+ * Same pattern as next-safe-action — callers check `result.ok` to
31
+ * determine success or failure with typed error info.
32
+ */
33
+ type ActionResult<T> = {
34
+ ok: true;
35
+ data: T;
36
+ } | {
37
+ ok: false;
38
+ error: string;
39
+ };
40
+ /**
41
+ * Wraps an async function call with error handling, returning an
42
+ * `ActionResult<T>` instead of throwing.
43
+ *
44
+ * Use this to eliminate try/catch boilerplate in server actions.
45
+ * Reads that go through React Query should NOT use this — let errors
46
+ * propagate so React Query can handle retries and error state.
47
+ *
48
+ * @param fn — The async function to execute
49
+ * @param onError — Optional callback for logging/reporting
50
+ *
51
+ * @example
52
+ * ```ts
53
+ * // Before (boilerplate wrapper):
54
+ * export async function addToCart(cartId: number, items: CartItem[]) {
55
+ * try {
56
+ * return await actions.commerce.addToCart(cartId, items);
57
+ * } catch (error) {
58
+ * console.error("addToCart error:", error);
59
+ * return undefined;
60
+ * }
61
+ * }
62
+ *
63
+ * // After (one-liner):
64
+ * const result = await safeAction(
65
+ * () => actions.commerce.addToCart(cartId, items),
66
+ * );
67
+ * if (result.ok) {
68
+ * // result.data is the response
69
+ * } else {
70
+ * // result.error is the error message
71
+ * }
72
+ * ```
73
+ */
74
+ declare function safeAction<T>(fn: () => Promise<T>, onError?: (error: Error) => void): Promise<ActionResult<T>>;
75
+
76
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
77
+ type PricingApiClient = Pick<AugurAPI, "pricing">;
21
78
  interface PricingActionsConfig {
22
79
  /** Default customer ID when none is provided by the caller. */
23
80
  defaultCustomerId?: string | number;
24
81
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
25
82
  cachePrefix?: string;
26
83
  /** CDN edge cache value passed to SDK. Default: 2 (hours). */
27
- edgeCache?: number;
84
+ edgeCache?: EdgeCacheValue;
28
85
  /** Redis TTL for price lookups in seconds. Default: 3600 (1 hour). */
29
86
  redisTtl?: number;
30
87
  /** Redis TTL for tax lookups in seconds. Default: 1800 (30 min). */
@@ -59,78 +116,15 @@ interface PricingActions {
59
116
  */
60
117
  declare function createPricingActions(api: PricingApiClient, config?: PricingActionsConfig): PricingActions;
61
118
 
62
- /**
63
- * The subset of augur-api used by item actions.
64
- * Avoids importing the full SDK type so augur-server stays lightweight.
65
- */
66
- interface ItemsApiClient {
67
- items: {
68
- categories: {
69
- get: (uid: number, params?: Record<string, unknown>) => Promise<{
70
- data: TCategory;
71
- }>;
72
- lookup: {
73
- get: (params: Record<string, unknown>) => Promise<{
74
- data: unknown;
75
- }>;
76
- };
77
- items: {
78
- list: (itemCategoryUid: number, params?: Record<string, unknown>) => Promise<{
79
- data: unknown;
80
- }>;
81
- };
82
- attributes: {
83
- list: (uid: number, params?: Record<string, unknown>) => Promise<{
84
- data: {
85
- attributes: TAttribute[];
86
- };
87
- }>;
88
- };
89
- };
90
- invMast: {
91
- get: (uid: number, params?: Record<string, unknown>) => Promise<{
92
- data: TInvMast;
93
- }>;
94
- doc: {
95
- list: (uid: number, params?: Record<string, unknown>) => Promise<{
96
- data: TInvMastDoc;
97
- }>;
98
- };
99
- stock: {
100
- list: (uid: number, params?: Record<string, unknown>) => Promise<{
101
- data: TStock;
102
- }>;
103
- };
104
- faq: {
105
- list: (uid: number, params?: Record<string, unknown>) => Promise<{
106
- data: unknown[];
107
- }>;
108
- };
109
- invSub: {
110
- list: (uid: number, params?: Record<string, unknown>) => Promise<{
111
- data: unknown[];
112
- }>;
113
- };
114
- invAccessory: {
115
- list: (uid: number, params?: Record<string, unknown>) => Promise<{
116
- data: TItemAccessory[];
117
- }>;
118
- };
119
- similar: {
120
- list: (uid: number, params?: Record<string, unknown>) => Promise<{
121
- data: unknown[];
122
- }>;
123
- };
124
- };
125
- };
126
- }
119
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
120
+ type ItemsApiClient = Pick<AugurAPI, "items">;
127
121
  interface ItemActionsConfig {
128
122
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
129
123
  cachePrefix?: string;
130
124
  /** CDN edge cache value for most calls. Default: 1 (hour). */
131
- edgeCache?: number;
125
+ edgeCache?: EdgeCacheValue;
132
126
  /** CDN edge cache for rarely-changing data like FAQs. Default: 8 (hours). */
133
- longEdgeCache?: number;
127
+ longEdgeCache?: EdgeCacheValue;
134
128
  /** Redis TTL for most calls in seconds. Default: 3600 (1 hour). */
135
129
  redisTtl?: number;
136
130
  /** Redis TTL for rarely-changing data in seconds. Default: 28800 (8 hours). */
@@ -186,49 +180,8 @@ interface ItemActions {
186
180
  */
187
181
  declare function createItemActions(api: ItemsApiClient, config?: ItemActionsConfig): ItemActions;
188
182
 
189
- /**
190
- * The subset of augur-api used by commerce actions.
191
- * Avoids importing the full SDK type so augur-server stays lightweight.
192
- */
193
- interface CommerceApiClient {
194
- commerce: {
195
- cartHdr: {
196
- lookup: {
197
- get: (params: Record<string, unknown>) => Promise<{
198
- data: TCartLookUp;
199
- }>;
200
- };
201
- alsoBought: {
202
- get: (cartHdrUid: number, params?: Record<string, unknown>) => Promise<{
203
- data: unknown[];
204
- }>;
205
- };
206
- };
207
- cartLine: {
208
- get: (cartHdrUid: number) => Promise<{
209
- data: TCartLine[];
210
- }>;
211
- add: {
212
- create: (cartHdrUid: number, params: Record<string, unknown>) => Promise<{
213
- data: unknown;
214
- }>;
215
- };
216
- update: {
217
- create: (cartHdrUid: number, params: Record<string, unknown>) => Promise<{
218
- data: unknown;
219
- }>;
220
- };
221
- delete: (cartHdrUid: number) => Promise<{
222
- data: unknown;
223
- }>;
224
- };
225
- checkout: {
226
- create: (params: Record<string, unknown>) => Promise<{
227
- data: unknown;
228
- }>;
229
- };
230
- };
231
- }
183
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
184
+ type CommerceApiClient = Pick<AugurAPI, "commerce">;
232
185
  interface CommerceActionsConfig {
233
186
  defaultContactId?: string | number;
234
187
  defaultCustomerId?: string | number;
@@ -283,31 +236,18 @@ interface CommerceActions {
283
236
  */
284
237
  declare function createCommerceActions(api: CommerceApiClient, config?: CommerceActionsConfig): CommerceActions;
285
238
 
286
- /**
287
- * The subset of augur-api used by order actions.
288
- * Avoids importing the full SDK type so augur-server stays lightweight.
289
- */
290
- interface OrderApiClient {
291
- orders: {
292
- oeHdr: {
293
- doc: {
294
- get: (params: Record<string, unknown>) => Promise<{
295
- data: unknown;
296
- }>;
297
- };
298
- };
299
- };
300
- }
239
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
240
+ type OrderApiClient = Pick<AugurAPI, "orders">;
301
241
  interface OrderActionsConfig {
302
242
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
303
243
  cachePrefix?: string;
304
244
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
305
- edgeCache?: number;
245
+ edgeCache?: EdgeCacheValue;
306
246
  /** Redis TTL for order doc lookups in seconds. Default: 3600 (1 hour). */
307
247
  redisTtl?: number;
308
248
  }
309
249
  interface OrderActions {
310
- getOrderDoc: (orderNo: string, zipCode: string) => Promise<unknown>;
250
+ getOrderDoc: (orderNo: string, postalCode: string) => Promise<unknown>;
311
251
  }
312
252
  /**
313
253
  * Creates server-side order actions with Redis caching and edge cache support.
@@ -331,50 +271,13 @@ interface OrderActions {
331
271
  */
332
272
  declare function createOrderActions(api: OrderApiClient, config?: OrderActionsConfig): OrderActions;
333
273
 
334
- /** Shape of the openSearch service used by search actions. */
335
- interface OpenSearchService {
336
- itemSearch: {
337
- list: (params: Record<string, unknown>) => Promise<{
338
- data: {
339
- items: TProductItem[];
340
- totalResults: number;
341
- };
342
- }>;
343
- attributes: {
344
- list: (params: Record<string, unknown>) => Promise<{
345
- data: {
346
- attributes: TAttribute[];
347
- };
348
- }>;
349
- };
350
- };
351
- suggestions: {
352
- suggest: {
353
- list: (params: Record<string, unknown>) => Promise<{
354
- data: {
355
- data: unknown[];
356
- total: number;
357
- totalResults: number;
358
- };
359
- }>;
360
- };
361
- };
362
- }
363
- /**
364
- * The subset of augur-api used by search actions.
365
- * Accepts both `openSearch` (camelCase) and `opensearch` (lowercase)
366
- * to match SDK v0.9.x which exposes `api.opensearch`.
367
- */
368
- type SearchApiClient = {
369
- openSearch: OpenSearchService;
370
- } | {
371
- opensearch: OpenSearchService;
372
- };
274
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
275
+ type SearchApiClient = Pick<AugurAPI, "opensearch">;
373
276
  interface SearchActionsConfig {
374
277
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
375
278
  cachePrefix?: string;
376
279
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
377
- edgeCache?: number;
280
+ edgeCache?: EdgeCacheValue;
378
281
  /** Redis TTL for search lookups in seconds. Default: 3600 (1 hour). */
379
282
  redisTtl?: number;
380
283
  /** Default source fields for item search. Default: "display_desc". */
@@ -410,6 +313,27 @@ interface SearchActions {
410
313
  filters?: [string, string][];
411
314
  }, itemCategoryUid?: number | string, pageParam?: number) => Promise<SearchPage>;
412
315
  }
316
+ /**
317
+ * Creates server-side search actions with Redis caching and edge cache support.
318
+ *
319
+ * Uses `withServerCache` which produces cache keys compatible with augur-hooks'
320
+ * `withCache`, so server-prefetched data is shared with client-side hooks.
321
+ *
322
+ * @example
323
+ * ```ts
324
+ * // lib/search-actions.ts
325
+ * import { createSearchActions } from "@simpleapps-com/augur-server";
326
+ * import { getAugurClient } from "./augur-client";
327
+ *
328
+ * export const searchActions = createSearchActions(getAugurClient(), {
329
+ * cachePrefix: "ampro:",
330
+ * });
331
+ *
332
+ * // In a server component:
333
+ * const attrs = await searchActions.getSearchAttributes("widget");
334
+ * const results = await searchActions.itemSearch({ q: "widget", limit: 20, offset: 0 });
335
+ * ```
336
+ */
413
337
  declare function createSearchActions(api: SearchApiClient, config?: SearchActionsConfig): SearchActions;
414
338
 
415
339
  interface ShippingAddress {
@@ -419,19 +343,8 @@ interface ShippingAddress {
419
343
  postalCode: string;
420
344
  country?: string;
421
345
  }
422
- /**
423
- * The subset of augur-api used by shipping actions.
424
- * Avoids importing the full SDK type so augur-server stays lightweight.
425
- */
426
- interface ShippingApiClient {
427
- ups: {
428
- ratesShop: {
429
- get: (params: Record<string, unknown>) => Promise<{
430
- data: unknown;
431
- }>;
432
- };
433
- };
434
- }
346
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
347
+ type ShippingApiClient = Pick<AugurAPI, "ups">;
435
348
  interface ShippingActionsConfig {
436
349
  /** Warehouse/origin address for rate calculations. */
437
350
  fromAddress: ShippingAddress;
@@ -440,7 +353,7 @@ interface ShippingActionsConfig {
440
353
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
441
354
  cachePrefix?: string;
442
355
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
443
- edgeCache?: number;
356
+ edgeCache?: EdgeCacheValue;
444
357
  /** Redis TTL for shipping rate lookups in seconds. Default: 3600 (1 hour). */
445
358
  redisTtl?: number;
446
359
  }
@@ -477,46 +390,13 @@ interface ShippingActions {
477
390
  */
478
391
  declare function createShippingActions(api: ShippingApiClient, config: ShippingActionsConfig): ShippingActions;
479
392
 
480
- /**
481
- * The subset of augur-api used by Joomla content actions.
482
- * Avoids importing the full SDK type so augur-server stays lightweight.
483
- */
484
- interface JoomlaApiClient {
485
- joomla: {
486
- content: {
487
- doc: {
488
- get: (articleId: number, params?: Record<string, unknown>) => Promise<{
489
- data: unknown;
490
- }>;
491
- };
492
- list: (params?: Record<string, unknown>) => Promise<{
493
- data: unknown[];
494
- }>;
495
- };
496
- menu: {
497
- doc: {
498
- get: (menuId: number | string, params?: Record<string, unknown>) => Promise<{
499
- data: unknown;
500
- }>;
501
- };
502
- list: (params?: Record<string, unknown>) => Promise<{
503
- data: unknown[];
504
- }>;
505
- };
506
- users: {
507
- doc: {
508
- get: (userId: number | string, params?: Record<string, unknown>) => Promise<{
509
- data: Record<string, unknown> | null;
510
- }>;
511
- };
512
- };
513
- };
514
- }
393
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
394
+ type JoomlaApiClient = Pick<AugurAPI, "joomla">;
515
395
  interface JoomlaActionsConfig {
516
396
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
517
397
  cachePrefix?: string;
518
398
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
519
- edgeCache?: number;
399
+ edgeCache?: EdgeCacheValue;
520
400
  /** Redis TTL for Joomla lookups in seconds. Default: 3600 (1 hour). */
521
401
  redisTtl?: number;
522
402
  }
@@ -557,45 +437,15 @@ interface JoomlaActions {
557
437
  */
558
438
  declare function createJoomlaActions(api: JoomlaApiClient, config?: JoomlaActionsConfig): JoomlaActions;
559
439
 
560
- /**
561
- * The subset of augur-api used by legacy actions.
562
- * Matches `api.legacy` from the SDK.
563
- */
564
- interface LegacyApiClient {
565
- legacy: {
566
- invMast: {
567
- webDesc: {
568
- list: (invMastUid: number, params?: Record<string, unknown>) => Promise<{
569
- data: TWebDesc[];
570
- }>;
571
- };
572
- alsoBought: {
573
- list: (invMastUid: number, params?: Record<string, unknown>) => Promise<{
574
- data: unknown[];
575
- }>;
576
- };
577
- tags: {
578
- list: (invMastUid: number, params?: Record<string, unknown>) => Promise<{
579
- data: unknown[];
580
- }>;
581
- };
582
- };
583
- legacy: {
584
- state: {
585
- list: (params?: Record<string, unknown>) => Promise<{
586
- data: unknown[];
587
- }>;
588
- };
589
- };
590
- };
591
- }
440
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
441
+ type LegacyApiClient = Pick<AugurAPI, "legacy">;
592
442
  interface LegacyActionsConfig {
593
443
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
594
444
  cachePrefix?: string;
595
445
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
596
- edgeCache?: number;
446
+ edgeCache?: EdgeCacheValue;
597
447
  /** CDN edge cache for rarely-changing data like states. Default: 8 (hours). */
598
- longEdgeCache?: number;
448
+ longEdgeCache?: EdgeCacheValue;
599
449
  /** Redis TTL in seconds. Default: 3600 (1 hour). */
600
450
  redisTtl?: number;
601
451
  /** Redis TTL for rarely-changing data in seconds. Default: 28800 (8 hours). */
@@ -634,71 +484,13 @@ interface CustomerListResult {
634
484
  data: unknown[];
635
485
  total: number;
636
486
  }
637
- /**
638
- * The subset of augur-api used by customer actions.
639
- * Matches `api.customers` from the SDK.
640
- */
641
- interface CustomersApiClient {
642
- customers: {
643
- customer: {
644
- get: (customerId: number, params?: Record<string, unknown>) => Promise<{
645
- data: unknown;
646
- }>;
647
- lookup: {
648
- get: (params: Record<string, unknown>) => Promise<{
649
- data: unknown[];
650
- }>;
651
- };
652
- doc: {
653
- list: (customerId: number, params?: Record<string, unknown>) => Promise<{
654
- data: unknown;
655
- }>;
656
- };
657
- orders: {
658
- get: (customerId: number, orderId: number, params?: Record<string, unknown>) => Promise<{
659
- data: unknown;
660
- }>;
661
- list: (customerId: number, params?: Record<string, unknown>) => Promise<{
662
- data: unknown[];
663
- total: number;
664
- }>;
665
- };
666
- invoices: {
667
- get: (customerId: number, invoiceNo: number, params?: Record<string, unknown>) => Promise<{
668
- data: unknown;
669
- }>;
670
- list: (customerId: number, params?: Record<string, unknown>) => Promise<{
671
- data: unknown[];
672
- total: number;
673
- }>;
674
- };
675
- quotes: {
676
- get: (customerId: number, quoteNo: number, params?: Record<string, unknown>) => Promise<{
677
- data: unknown;
678
- }>;
679
- list: (customerId: number, params?: Record<string, unknown>) => Promise<{
680
- data: unknown[];
681
- total: number;
682
- }>;
683
- };
684
- shipTo: {
685
- list: (customerId: number, params?: Record<string, unknown>) => Promise<{
686
- data: unknown[];
687
- }>;
688
- };
689
- };
690
- contacts: {
691
- list: (params?: Record<string, unknown>) => Promise<{
692
- data: unknown[];
693
- }>;
694
- };
695
- };
696
- }
487
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
488
+ type CustomersApiClient = Pick<AugurAPI, "customers">;
697
489
  interface CustomersActionsConfig {
698
490
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
699
491
  cachePrefix?: string;
700
492
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
701
- edgeCache?: number;
493
+ edgeCache?: EdgeCacheValue;
702
494
  /** Redis TTL in seconds. Default: 3600 (1 hour). */
703
495
  redisTtl?: number;
704
496
  }
@@ -736,21 +528,8 @@ interface CustomersActions {
736
528
  */
737
529
  declare function createCustomersActions(api: CustomersApiClient, config?: CustomersActionsConfig): CustomersActions;
738
530
 
739
- /**
740
- * The subset of augur-api used by SmartyStreets actions.
741
- * Matches `api.smartyStreets` from the SDK.
742
- */
743
- interface SmartyStreetsApiClient {
744
- smartyStreets: {
745
- us: {
746
- lookup: {
747
- get: (params: Record<string, unknown>) => Promise<{
748
- data: TSmartyStreets | undefined;
749
- }>;
750
- };
751
- };
752
- };
753
- }
531
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
532
+ type SmartyStreetsApiClient = Pick<AugurAPI, "smartyStreets">;
754
533
  interface SmartyStreetsActionsConfig {
755
534
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
756
535
  cachePrefix?: string;
@@ -792,27 +571,13 @@ interface SmartyStreetsActions {
792
571
  */
793
572
  declare function createSmartyStreetsActions(api: SmartyStreetsApiClient, config?: SmartyStreetsActionsConfig): SmartyStreetsActions;
794
573
 
795
- /**
796
- * The subset of augur-api used by P21 PIM actions.
797
- * Matches `api.p21Pim` from the SDK.
798
- */
799
- interface P21PimApiClient {
800
- p21Pim: {
801
- invMastExt: {
802
- get: (invMastUid: number, params?: Record<string, unknown>) => Promise<{
803
- data: unknown;
804
- }>;
805
- list: (params?: Record<string, unknown>) => Promise<{
806
- data: unknown[];
807
- }>;
808
- };
809
- };
810
- }
574
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
575
+ type P21PimApiClient = Pick<AugurAPI, "p21Pim">;
811
576
  interface P21PimActionsConfig {
812
577
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
813
578
  cachePrefix?: string;
814
579
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
815
- edgeCache?: number;
580
+ edgeCache?: EdgeCacheValue;
816
581
  /** Redis TTL in seconds. Default: 3600 (1 hour). */
817
582
  redisTtl?: number;
818
583
  }
@@ -841,29 +606,13 @@ interface P21PimActions {
841
606
  */
842
607
  declare function createP21PimActions(api: P21PimApiClient, config?: P21PimActionsConfig): P21PimActions;
843
608
 
844
- /**
845
- * The subset of augur-api used by AGR Site actions.
846
- * Matches `api.agrSite` from the SDK.
847
- */
848
- interface AgrSiteApiClient {
849
- agrSite: {
850
- settings: {
851
- list: (params?: Record<string, unknown>) => Promise<{
852
- data: unknown[];
853
- }>;
854
- };
855
- metaFiles: {
856
- list: (params?: Record<string, unknown>) => Promise<{
857
- data: unknown[];
858
- }>;
859
- };
860
- };
861
- }
609
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
610
+ type AgrSiteApiClient = Pick<AugurAPI, "agrSite">;
862
611
  interface AgrSiteActionsConfig {
863
612
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
864
613
  cachePrefix?: string;
865
614
  /** CDN edge cache value for rarely-changing data. Default: 8 (hours). */
866
- longEdgeCache?: number;
615
+ longEdgeCache?: EdgeCacheValue;
867
616
  /** Redis TTL for rarely-changing data in seconds. Default: 28800 (8 hours). */
868
617
  longRedisTtl?: number;
869
618
  }
@@ -893,19 +642,8 @@ interface AgrSiteActions {
893
642
  */
894
643
  declare function createAgrSiteActions(api: AgrSiteApiClient, config?: AgrSiteActionsConfig): AgrSiteActions;
895
644
 
896
- /**
897
- * The subset of augur-api used by Avalara actions.
898
- * Matches `api.avalara` from the SDK.
899
- */
900
- interface AvalaraApiClient {
901
- avalara: {
902
- rates: {
903
- create: (data: Record<string, unknown>) => Promise<{
904
- data: unknown;
905
- }>;
906
- };
907
- };
908
- }
645
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
646
+ type AvalaraApiClient = Pick<AugurAPI, "avalara">;
909
647
  interface AvalaraActionsConfig {
910
648
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
911
649
  cachePrefix?: string;
@@ -943,46 +681,8 @@ interface AvalaraActions {
943
681
  */
944
682
  declare function createAvalaraActions(api: AvalaraApiClient, config?: AvalaraActionsConfig): AvalaraActions;
945
683
 
946
- /**
947
- * The subset of augur-api used by payment actions.
948
- * Matches `api.payments` from the SDK.
949
- */
950
- interface PaymentsApiClient {
951
- payments: {
952
- unified: {
953
- transactionSetup: {
954
- get: (params: Record<string, unknown>) => Promise<{
955
- data: unknown;
956
- }>;
957
- };
958
- accountQuery: {
959
- get: (params: Record<string, unknown>) => Promise<{
960
- data: unknown;
961
- }>;
962
- };
963
- surcharge: {
964
- get: (params: Record<string, unknown>) => Promise<{
965
- data: unknown;
966
- }>;
967
- };
968
- cardInfo: {
969
- get: (params: Record<string, unknown>) => Promise<{
970
- data: unknown;
971
- }>;
972
- };
973
- billingUpdate: {
974
- get: (params: Record<string, unknown>) => Promise<{
975
- data: unknown;
976
- }>;
977
- };
978
- validate: {
979
- get: (params: Record<string, unknown>) => Promise<{
980
- data: unknown;
981
- }>;
982
- };
983
- };
984
- };
985
- }
684
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
685
+ type PaymentsApiClient = Pick<AugurAPI, "payments">;
986
686
  interface PaymentsActionsConfig {
987
687
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
988
688
  cachePrefix?: string;
@@ -1017,19 +717,8 @@ interface PaymentsActions {
1017
717
  */
1018
718
  declare function createPaymentsActions(api: PaymentsApiClient, config?: PaymentsActionsConfig): PaymentsActions;
1019
719
 
1020
- /**
1021
- * The subset of augur-api used by UPS actions.
1022
- * Matches `api.ups` from the SDK.
1023
- */
1024
- interface UpsApiClient {
1025
- ups: {
1026
- ratesShop: {
1027
- get: (params: Record<string, unknown>) => Promise<{
1028
- data: unknown;
1029
- }>;
1030
- };
1031
- };
1032
- }
720
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
721
+ type UpsApiClient = Pick<AugurAPI, "ups">;
1033
722
  interface UpsActionsConfig {
1034
723
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
1035
724
  cachePrefix?: string;
@@ -1059,35 +748,15 @@ interface UpsActions {
1059
748
  */
1060
749
  declare function createUpsActions(api: UpsApiClient, config?: UpsActionsConfig): UpsActions;
1061
750
 
1062
- /**
1063
- * The subset of augur-api used by logistics actions.
1064
- * Matches `api.logistics` from the SDK.
1065
- */
1066
- interface LogisticsApiClient {
1067
- logistics: {
1068
- speedship: {
1069
- freight: {
1070
- get: (params: Record<string, unknown>) => Promise<{
1071
- data: unknown;
1072
- }>;
1073
- };
1074
- };
1075
- shipvia: {
1076
- rates: {
1077
- list: (params?: Record<string, unknown>) => Promise<{
1078
- data: unknown[];
1079
- }>;
1080
- };
1081
- };
1082
- };
1083
- }
751
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
752
+ type LogisticsApiClient = Pick<AugurAPI, "logistics">;
1084
753
  interface LogisticsActionsConfig {
1085
754
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
1086
755
  cachePrefix?: string;
1087
756
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
1088
- edgeCache?: number;
757
+ edgeCache?: EdgeCacheValue;
1089
758
  /** CDN edge cache for rarely-changing data like ship-via options. Default: 8 (hours). */
1090
- longEdgeCache?: number;
759
+ longEdgeCache?: EdgeCacheValue;
1091
760
  /** Redis TTL in seconds. Default: 3600 (1 hour). */
1092
761
  redisTtl?: number;
1093
762
  /** Redis TTL for rarely-changing data in seconds. Default: 28800 (8 hours). */
@@ -1118,49 +787,13 @@ interface LogisticsActions {
1118
787
  */
1119
788
  declare function createLogisticsActions(api: LogisticsApiClient, config?: LogisticsActionsConfig): LogisticsActions;
1120
789
 
1121
- /**
1122
- * The subset of augur-api used by nexus actions.
1123
- * Matches `api.nexus` from the SDK.
1124
- */
1125
- interface NexusApiClient {
1126
- nexus: {
1127
- binTransfer: {
1128
- create: (data: Record<string, unknown>) => Promise<{
1129
- data: unknown;
1130
- }>;
1131
- };
1132
- receiving: {
1133
- create: (data: Record<string, unknown>) => Promise<{
1134
- data: unknown;
1135
- }>;
1136
- };
1137
- transfer: {
1138
- create: (data: Record<string, unknown>) => Promise<{
1139
- data: unknown;
1140
- }>;
1141
- };
1142
- purchaseOrderReceipt: {
1143
- list: (params?: Record<string, unknown>) => Promise<{
1144
- data: unknown[];
1145
- }>;
1146
- };
1147
- transferReceipt: {
1148
- list: (params?: Record<string, unknown>) => Promise<{
1149
- data: unknown[];
1150
- }>;
1151
- };
1152
- transferShipping: {
1153
- list: (params?: Record<string, unknown>) => Promise<{
1154
- data: unknown[];
1155
- }>;
1156
- };
1157
- };
1158
- }
790
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
791
+ type NexusApiClient = Pick<AugurAPI, "nexus">;
1159
792
  interface NexusActionsConfig {
1160
793
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
1161
794
  cachePrefix?: string;
1162
795
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
1163
- edgeCache?: number;
796
+ edgeCache?: EdgeCacheValue;
1164
797
  /** Redis TTL in seconds. Default: 3600 (1 hour). */
1165
798
  redisTtl?: number;
1166
799
  }
@@ -1193,54 +826,13 @@ interface NexusActions {
1193
826
  */
1194
827
  declare function createNexusActions(api: NexusApiClient, config?: NexusActionsConfig): NexusActions;
1195
828
 
1196
- /**
1197
- * The subset of augur-api used by VMI actions.
1198
- * Matches `api.vmi` from the SDK.
1199
- */
1200
- interface VmiApiClient {
1201
- vmi: {
1202
- warehouse: {
1203
- list: (params?: Record<string, unknown>) => Promise<{
1204
- data: unknown[];
1205
- }>;
1206
- availability: {
1207
- get: (warehouseUid: number, params: Record<string, unknown>) => Promise<{
1208
- data: unknown[];
1209
- }>;
1210
- };
1211
- };
1212
- distributors: {
1213
- list: (params?: Record<string, unknown>) => Promise<{
1214
- data: unknown[];
1215
- }>;
1216
- };
1217
- products: {
1218
- list: (params?: Record<string, unknown>) => Promise<{
1219
- data: unknown[];
1220
- }>;
1221
- };
1222
- invProfileHdr: {
1223
- list: (params?: Record<string, unknown>) => Promise<{
1224
- data: unknown[];
1225
- }>;
1226
- };
1227
- restockHdr: {
1228
- list: (params?: Record<string, unknown>) => Promise<{
1229
- data: unknown[];
1230
- }>;
1231
- };
1232
- sections: {
1233
- list: (params?: Record<string, unknown>) => Promise<{
1234
- data: unknown[];
1235
- }>;
1236
- };
1237
- };
1238
- }
829
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
830
+ type VmiApiClient = Pick<AugurAPI, "vmi">;
1239
831
  interface VmiActionsConfig {
1240
832
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
1241
833
  cachePrefix?: string;
1242
834
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
1243
- edgeCache?: number;
835
+ edgeCache?: EdgeCacheValue;
1244
836
  /** Redis TTL in seconds. Default: 3600 (1 hour). */
1245
837
  redisTtl?: number;
1246
838
  /** Redis TTL for short-lived data like availability. Default: 300 (5 min). */
@@ -1277,54 +869,15 @@ interface VmiActions {
1277
869
  */
1278
870
  declare function createVmiActions(api: VmiApiClient, config?: VmiActionsConfig): VmiActions;
1279
871
 
1280
- /**
1281
- * The subset of augur-api used by p21-core actions.
1282
- * Matches `api.p21Core` from the SDK.
1283
- */
1284
- interface P21CoreApiClient {
1285
- p21Core: {
1286
- address: {
1287
- list: (params?: Record<string, unknown>) => Promise<{
1288
- data: unknown[];
1289
- }>;
1290
- };
1291
- company: {
1292
- list: (params?: Record<string, unknown>) => Promise<{
1293
- data: unknown[];
1294
- }>;
1295
- get: (params: Record<string, unknown>) => Promise<{
1296
- data: unknown;
1297
- }>;
1298
- };
1299
- location: {
1300
- list: (params?: Record<string, unknown>) => Promise<{
1301
- data: unknown[];
1302
- }>;
1303
- };
1304
- paymentTypes: {
1305
- list: (params?: Record<string, unknown>) => Promise<{
1306
- data: unknown[];
1307
- }>;
1308
- };
1309
- cashDrawer: {
1310
- list: (params?: Record<string, unknown>) => Promise<{
1311
- data: unknown[];
1312
- }>;
1313
- };
1314
- codeP21: {
1315
- list: (params?: Record<string, unknown>) => Promise<{
1316
- data: unknown[];
1317
- }>;
1318
- };
1319
- };
1320
- }
872
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
873
+ type P21CoreApiClient = Pick<AugurAPI, "p21Core">;
1321
874
  interface P21CoreActionsConfig {
1322
875
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
1323
876
  cachePrefix?: string;
1324
877
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
1325
- edgeCache?: number;
878
+ edgeCache?: EdgeCacheValue;
1326
879
  /** CDN edge cache for rarely-changing data. Default: 8 (hours). */
1327
- longEdgeCache?: number;
880
+ longEdgeCache?: EdgeCacheValue;
1328
881
  /** Redis TTL in seconds. Default: 3600 (1 hour). */
1329
882
  redisTtl?: number;
1330
883
  /** Redis TTL for rarely-changing data in seconds. Default: 28800 (8 hours). */
@@ -1360,63 +913,13 @@ interface P21CoreActions {
1360
913
  */
1361
914
  declare function createP21CoreActions(api: P21CoreApiClient, config?: P21CoreActionsConfig): P21CoreActions;
1362
915
 
1363
- /**
1364
- * The subset of augur-api used by p21-apis actions.
1365
- * Matches `api.p21Apis` from the SDK.
1366
- */
1367
- interface P21ApisApiClient {
1368
- p21Apis: {
1369
- transCategory: {
1370
- list: (params?: Record<string, unknown>) => Promise<{
1371
- data: unknown[];
1372
- }>;
1373
- defaults: {
1374
- get: (categoryUid: number, params?: Record<string, unknown>) => Promise<{
1375
- data: unknown;
1376
- }>;
1377
- };
1378
- };
1379
- transCompany: {
1380
- list: (params?: Record<string, unknown>) => Promise<{
1381
- data: unknown[];
1382
- }>;
1383
- };
1384
- transUser: {
1385
- list: (params?: Record<string, unknown>) => Promise<{
1386
- data: unknown[];
1387
- }>;
1388
- };
1389
- transWebDisplayType: {
1390
- list: (params?: Record<string, unknown>) => Promise<{
1391
- data: unknown[];
1392
- }>;
1393
- defaults: {
1394
- get: (params?: Record<string, unknown>) => Promise<{
1395
- data: unknown;
1396
- }>;
1397
- };
1398
- };
1399
- entityContacts: {
1400
- refresh: {
1401
- create: (params?: Record<string, unknown>) => Promise<{
1402
- data: unknown;
1403
- }>;
1404
- };
1405
- };
1406
- entityCustomers: {
1407
- refresh: {
1408
- create: (params?: Record<string, unknown>) => Promise<{
1409
- data: unknown;
1410
- }>;
1411
- };
1412
- };
1413
- };
1414
- }
916
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
917
+ type P21ApisApiClient = Pick<AugurAPI, "p21Apis">;
1415
918
  interface P21ApisActionsConfig {
1416
919
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
1417
920
  cachePrefix?: string;
1418
921
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
1419
- edgeCache?: number;
922
+ edgeCache?: EdgeCacheValue;
1420
923
  /** Redis TTL in seconds. Default: 3600 (1 hour). */
1421
924
  redisTtl?: number;
1422
925
  }
@@ -1451,39 +954,13 @@ interface P21ApisActions {
1451
954
  */
1452
955
  declare function createP21ApisActions(api: P21ApisApiClient, config?: P21ApisActionsConfig): P21ApisActions;
1453
956
 
1454
- /**
1455
- * The subset of augur-api used by p21-sism actions.
1456
- * Matches `api.p21Sism` from the SDK.
1457
- */
1458
- interface P21SismApiClient {
1459
- p21Sism: {
1460
- import: {
1461
- recent: {
1462
- list: (params?: Record<string, unknown>) => Promise<{
1463
- data: unknown[];
1464
- }>;
1465
- };
1466
- get: (importUid: string) => Promise<{
1467
- data: unknown;
1468
- }>;
1469
- };
1470
- impOeLine: {
1471
- list: (params?: Record<string, unknown>) => Promise<{
1472
- data: unknown[];
1473
- }>;
1474
- };
1475
- scheduledImportMaster: {
1476
- list: (params?: Record<string, unknown>) => Promise<{
1477
- data: unknown[];
1478
- }>;
1479
- };
1480
- };
1481
- }
957
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
958
+ type P21SismApiClient = Pick<AugurAPI, "p21Sism">;
1482
959
  interface P21SismActionsConfig {
1483
960
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
1484
961
  cachePrefix?: string;
1485
962
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
1486
- edgeCache?: number;
963
+ edgeCache?: EdgeCacheValue;
1487
964
  /** Redis TTL in seconds. Default: 3600 (1 hour). */
1488
965
  redisTtl?: number;
1489
966
  }
@@ -1514,24 +991,8 @@ interface P21SismActions {
1514
991
  */
1515
992
  declare function createP21SismActions(api: P21SismApiClient, config?: P21SismActionsConfig): P21SismActions;
1516
993
 
1517
- /**
1518
- * The subset of augur-api used by agr-work actions.
1519
- * Matches `api.agrWork` from the SDK.
1520
- */
1521
- interface AgrWorkApiClient {
1522
- agrWork: {
1523
- healthCheck: {
1524
- get: () => Promise<{
1525
- data: string;
1526
- }>;
1527
- };
1528
- ping: {
1529
- get: () => Promise<{
1530
- data: string;
1531
- }>;
1532
- };
1533
- };
1534
- }
994
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
995
+ type AgrWorkApiClient = Pick<AugurAPI, "agrWork">;
1535
996
  interface AgrWorkActionsConfig {
1536
997
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
1537
998
  cachePrefix?: string;
@@ -1559,50 +1020,15 @@ interface AgrWorkActions {
1559
1020
  */
1560
1021
  declare function createAgrWorkActions(api: AgrWorkApiClient, _config?: AgrWorkActionsConfig): AgrWorkActions;
1561
1022
 
1562
- /**
1563
- * The subset of augur-api used by agr-info actions.
1564
- * Matches `api.agrInfo` from the SDK.
1565
- */
1566
- interface AgrInfoApiClient {
1567
- agrInfo: {
1568
- context: {
1569
- get: (siteId: string, params?: Record<string, unknown>) => Promise<{
1570
- data: unknown;
1571
- }>;
1572
- };
1573
- rubrics: {
1574
- list: (params?: Record<string, unknown>) => Promise<{
1575
- data: unknown[];
1576
- }>;
1577
- };
1578
- microservices: {
1579
- list: (params?: Record<string, unknown>) => Promise<{
1580
- data: unknown[];
1581
- }>;
1582
- };
1583
- akasha: {
1584
- generate: {
1585
- create: (params?: Record<string, unknown>) => Promise<{
1586
- data: unknown;
1587
- }>;
1588
- };
1589
- };
1590
- joomla: {
1591
- generate: {
1592
- create: (params?: Record<string, unknown>) => Promise<{
1593
- data: unknown;
1594
- }>;
1595
- };
1596
- };
1597
- };
1598
- }
1023
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
1024
+ type AgrInfoApiClient = Pick<AugurAPI, "agrInfo">;
1599
1025
  interface AgrInfoActionsConfig {
1600
1026
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
1601
1027
  cachePrefix?: string;
1602
1028
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
1603
- edgeCache?: number;
1029
+ edgeCache?: EdgeCacheValue;
1604
1030
  /** CDN edge cache for rarely-changing data. Default: 8 (hours). */
1605
- longEdgeCache?: number;
1031
+ longEdgeCache?: EdgeCacheValue;
1606
1032
  /** Redis TTL in seconds. Default: 3600 (1 hour). */
1607
1033
  redisTtl?: number;
1608
1034
  /** Redis TTL for rarely-changing data in seconds. Default: 28800 (8 hours). */
@@ -1636,64 +1062,15 @@ interface AgrInfoActions {
1636
1062
  */
1637
1063
  declare function createAgrInfoActions(api: AgrInfoApiClient, config?: AgrInfoActionsConfig): AgrInfoActions;
1638
1064
 
1639
- /**
1640
- * The subset of augur-api used by basecamp2 actions.
1641
- * Matches `api.basecamp2` from the SDK.
1642
- */
1643
- interface Basecamp2ApiClient {
1644
- basecamp2: {
1645
- todos: {
1646
- list: (params?: Record<string, unknown>) => Promise<{
1647
- data: unknown[];
1648
- }>;
1649
- get: (todoId: number, params?: Record<string, unknown>) => Promise<{
1650
- data: unknown;
1651
- }>;
1652
- };
1653
- todosSummary: {
1654
- list: (params?: Record<string, unknown>) => Promise<{
1655
- data: unknown[];
1656
- }>;
1657
- };
1658
- comments: {
1659
- list: (params?: Record<string, unknown>) => Promise<{
1660
- data: unknown[];
1661
- }>;
1662
- };
1663
- people: {
1664
- list: (params?: Record<string, unknown>) => Promise<{
1665
- data: unknown[];
1666
- }>;
1667
- };
1668
- projects: {
1669
- list: (params?: Record<string, unknown>) => Promise<{
1670
- data: unknown[];
1671
- }>;
1672
- };
1673
- events: {
1674
- list: (params?: Record<string, unknown>) => Promise<{
1675
- data: unknown[];
1676
- }>;
1677
- };
1678
- metrics: {
1679
- list: (params?: Record<string, unknown>) => Promise<{
1680
- data: unknown[];
1681
- }>;
1682
- };
1683
- todolists: {
1684
- list: (params?: Record<string, unknown>) => Promise<{
1685
- data: unknown[];
1686
- }>;
1687
- };
1688
- };
1689
- }
1065
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
1066
+ type Basecamp2ApiClient = Pick<AugurAPI, "basecamp2">;
1690
1067
  interface Basecamp2ActionsConfig {
1691
1068
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
1692
1069
  cachePrefix?: string;
1693
1070
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
1694
- edgeCache?: number;
1071
+ edgeCache?: EdgeCacheValue;
1695
1072
  /** CDN edge cache for rarely-changing data like people. Default: 8 (hours). */
1696
- longEdgeCache?: number;
1073
+ longEdgeCache?: EdgeCacheValue;
1697
1074
  /** Redis TTL in seconds. Default: 3600 (1 hour). */
1698
1075
  redisTtl?: number;
1699
1076
  /** Redis TTL for rarely-changing data in seconds. Default: 28800 (8 hours). */
@@ -1731,32 +1108,13 @@ interface Basecamp2Actions {
1731
1108
  */
1732
1109
  declare function createBasecamp2Actions(api: Basecamp2ApiClient, config?: Basecamp2ActionsConfig): Basecamp2Actions;
1733
1110
 
1734
- /**
1735
- * The subset of augur-api used by brand-folder actions.
1736
- * Matches `api.brandFolder` from the SDK.
1737
- */
1738
- interface BrandFolderApiClient {
1739
- brandFolder: {
1740
- categories: {
1741
- list: (params?: Record<string, unknown>) => Promise<{
1742
- data: unknown[];
1743
- }>;
1744
- get: (categoryId: string, params?: Record<string, unknown>) => Promise<{
1745
- data: unknown;
1746
- }>;
1747
- focus: {
1748
- create: (params: Record<string, unknown>) => Promise<{
1749
- data: unknown;
1750
- }>;
1751
- };
1752
- };
1753
- };
1754
- }
1111
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
1112
+ type BrandFolderApiClient = Pick<AugurAPI, "brandFolder">;
1755
1113
  interface BrandFolderActionsConfig {
1756
1114
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
1757
1115
  cachePrefix?: string;
1758
1116
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
1759
- edgeCache?: number;
1117
+ edgeCache?: EdgeCacheValue;
1760
1118
  /** Redis TTL in seconds. Default: 3600 (1 hour). */
1761
1119
  redisTtl?: number;
1762
1120
  }
@@ -1787,41 +1145,13 @@ interface BrandFolderActions {
1787
1145
  */
1788
1146
  declare function createBrandFolderActions(api: BrandFolderApiClient, config?: BrandFolderActionsConfig): BrandFolderActions;
1789
1147
 
1790
- /**
1791
- * The subset of augur-api used by gregorovich actions.
1792
- * Matches `api.gregorovich` from the SDK.
1793
- */
1794
- interface GregorovichApiClient {
1795
- gregorovich: {
1796
- chatGpt: {
1797
- ask: {
1798
- get: (params: Record<string, unknown>) => Promise<{
1799
- data: unknown;
1800
- }>;
1801
- };
1802
- };
1803
- documents: {
1804
- list: (params?: Record<string, unknown>) => Promise<{
1805
- data: unknown[];
1806
- }>;
1807
- create: (data: Record<string, unknown>) => Promise<{
1808
- data: unknown;
1809
- }>;
1810
- };
1811
- ollama: {
1812
- generate: {
1813
- create: (data: Record<string, unknown>) => Promise<{
1814
- data: unknown;
1815
- }>;
1816
- };
1817
- };
1818
- };
1819
- }
1148
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
1149
+ type GregorovichApiClient = Pick<AugurAPI, "gregorovich">;
1820
1150
  interface GregorovichActionsConfig {
1821
1151
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
1822
1152
  cachePrefix?: string;
1823
1153
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
1824
- edgeCache?: number;
1154
+ edgeCache?: EdgeCacheValue;
1825
1155
  /** Redis TTL in seconds. Default: 3600 (1 hour). */
1826
1156
  redisTtl?: number;
1827
1157
  }
@@ -1852,27 +1182,13 @@ interface GregorovichActions {
1852
1182
  */
1853
1183
  declare function createGregorovichActions(api: GregorovichApiClient, config?: GregorovichActionsConfig): GregorovichActions;
1854
1184
 
1855
- /**
1856
- * The subset of augur-api used by slack actions.
1857
- * Matches `api.slack` from the SDK.
1858
- */
1859
- interface SlackApiClient {
1860
- slack: {
1861
- webHook: {
1862
- create: (data: Record<string, unknown>) => Promise<{
1863
- data: unknown;
1864
- }>;
1865
- list: (params?: Record<string, unknown>) => Promise<{
1866
- data: unknown[];
1867
- }>;
1868
- };
1869
- };
1870
- }
1185
+ /** Derived from augur-api SDK — keeps types in sync automatically. */
1186
+ type SlackApiClient = Pick<AugurAPI, "slack">;
1871
1187
  interface SlackActionsConfig {
1872
1188
  /** Cache key prefix (e.g. "ampro:"). Default: "". */
1873
1189
  cachePrefix?: string;
1874
1190
  /** CDN edge cache value passed to SDK. Default: 1 (hour). */
1875
- edgeCache?: number;
1191
+ edgeCache?: EdgeCacheValue;
1876
1192
  /** Redis TTL in seconds. Default: 3600 (1 hour). */
1877
1193
  redisTtl?: number;
1878
1194
  }
@@ -1904,11 +1220,11 @@ interface SiteActionsConfig {
1904
1220
  /** Cache key prefix shared across all services (e.g. "ampro:") */
1905
1221
  cachePrefix?: string;
1906
1222
  /** Default edge cache TTL in seconds */
1907
- edgeCache?: number;
1223
+ edgeCache?: EdgeCacheValue;
1908
1224
  /** Default Redis TTL in seconds */
1909
1225
  redisTtl?: number;
1910
1226
  /** Long-lived edge cache TTL for rarely-changing data */
1911
- longEdgeCache?: number;
1227
+ longEdgeCache?: EdgeCacheValue;
1912
1228
  /** Long-lived Redis TTL for rarely-changing data */
1913
1229
  longRedisTtl?: number;
1914
1230
  /** Default contact ID for commerce operations */
@@ -2005,4 +1321,4 @@ interface SiteActions {
2005
1321
  */
2006
1322
  declare function createSiteActions<TApi extends object>(api: TApi, config?: SiteActionsConfig): SiteActions;
2007
1323
 
2008
- export { type P21CoreApiClient as $, type AddressValidationResult as A, type Basecamp2Actions as B, type CommerceActions as C, type ItemsApiClient as D, type JoomlaActionsConfig as E, type JoomlaApiClient as F, type GregorovichActions as G, type LegacyActionsConfig as H, type ItemActions as I, type JoomlaActions as J, type LegacyApiClient as K, type LegacyActions as L, type LogisticsActions as M, type LogisticsActionsConfig as N, type LogisticsApiClient as O, type NexusActions as P, type NexusActionsConfig as Q, type NexusApiClient as R, type NormalizedUserProfile as S, type OrderActions as T, type OrderActionsConfig as U, type OrderApiClient as V, type P21ApisActions as W, type P21ApisActionsConfig as X, type P21ApisApiClient as Y, type P21CoreActions as Z, type P21CoreActionsConfig as _, type AgrInfoActions as a, type P21PimActions as a0, type P21PimActionsConfig as a1, type P21PimApiClient as a2, type P21SismActions as a3, type P21SismActionsConfig as a4, type P21SismApiClient as a5, type PaymentsActions as a6, type PaymentsActionsConfig as a7, type PaymentsApiClient as a8, type PricingActions as a9, createAgrWorkActions as aA, createAvalaraActions as aB, createBasecamp2Actions as aC, createBrandFolderActions as aD, createCommerceActions as aE, createCustomersActions as aF, createGregorovichActions as aG, createItemActions as aH, createJoomlaActions as aI, createLegacyActions as aJ, createLogisticsActions as aK, createNexusActions as aL, createOrderActions as aM, createP21ApisActions as aN, createP21CoreActions as aO, createP21PimActions as aP, createP21SismActions as aQ, createPaymentsActions as aR, createPricingActions as aS, createSearchActions as aT, createShippingActions as aU, createSiteActions as aV, createSlackActions as aW, createSmartyStreetsActions as aX, createUpsActions as aY, createVmiActions as aZ, type PricingActionsConfig as aa, type PricingApiClient as ab, type SearchActions as ac, type SearchActionsConfig as ad, type SearchApiClient as ae, type SearchPage as af, type ShippingActions as ag, type ShippingActionsConfig as ah, type ShippingAddress as ai, type ShippingApiClient as aj, type SiteActions as ak, type SiteActionsConfig as al, type SlackActions as am, type SlackActionsConfig as an, type SlackApiClient as ao, type SmartyStreetsActions as ap, type SmartyStreetsActionsConfig as aq, type SmartyStreetsApiClient as ar, type UpsActions as as, type UpsActionsConfig as at, type UpsApiClient as au, type VmiActions as av, type VmiActionsConfig as aw, type VmiApiClient as ax, createAgrInfoActions as ay, createAgrSiteActions as az, type AgrInfoActionsConfig as b, type AgrInfoApiClient as c, type AgrSiteActions as d, type AgrSiteActionsConfig as e, type AgrSiteApiClient as f, type AgrWorkActions as g, type AgrWorkActionsConfig as h, type AgrWorkApiClient as i, type AvalaraActions as j, type AvalaraActionsConfig as k, type AvalaraApiClient as l, type Basecamp2ActionsConfig as m, type Basecamp2ApiClient as n, type BrandFolderActions as o, type BrandFolderActionsConfig as p, type BrandFolderApiClient as q, type CommerceActionsConfig as r, type CommerceApiClient as s, type CustomerListResult as t, type CustomersActions as u, type CustomersActionsConfig as v, type CustomersApiClient as w, type GregorovichActionsConfig as x, type GregorovichApiClient as y, type ItemActionsConfig as z };
1324
+ export { type P21CoreActions as $, type ActionResult as A, type Basecamp2Actions as B, type CommerceActions as C, type ItemActionsConfig as D, type EdgeCacheValue as E, type ItemsApiClient as F, type GregorovichActions as G, type JoomlaActionsConfig as H, type ItemActions as I, type JoomlaActions as J, type JoomlaApiClient as K, type LegacyActions as L, type LegacyActionsConfig as M, type LegacyApiClient as N, type LogisticsActions as O, type LogisticsActionsConfig as P, type LogisticsApiClient as Q, type NexusActions as R, type NexusActionsConfig as S, type NexusApiClient as T, type NormalizedUserProfile as U, type OrderActions as V, type OrderActionsConfig as W, type OrderApiClient as X, type P21ApisActions as Y, type P21ApisActionsConfig as Z, type P21ApisApiClient as _, type AddressValidationResult as a, createVmiActions as a$, type P21CoreActionsConfig as a0, type P21CoreApiClient as a1, type P21PimActions as a2, type P21PimActionsConfig as a3, type P21PimApiClient as a4, type P21SismActions as a5, type P21SismActionsConfig as a6, type P21SismApiClient as a7, type PaymentsActions as a8, type PaymentsActionsConfig as a9, createAgrInfoActions as aA, createAgrSiteActions as aB, createAgrWorkActions as aC, createAvalaraActions as aD, createBasecamp2Actions as aE, createBrandFolderActions as aF, createCommerceActions as aG, createCustomersActions as aH, createGregorovichActions as aI, createItemActions as aJ, createJoomlaActions as aK, createLegacyActions as aL, createLogisticsActions as aM, createNexusActions as aN, createOrderActions as aO, createP21ApisActions as aP, createP21CoreActions as aQ, createP21PimActions as aR, createP21SismActions as aS, createPaymentsActions as aT, createPricingActions as aU, createSearchActions as aV, createShippingActions as aW, createSiteActions as aX, createSlackActions as aY, createSmartyStreetsActions as aZ, createUpsActions as a_, type PaymentsApiClient as aa, type PricingActions as ab, type PricingActionsConfig as ac, type PricingApiClient as ad, type SearchActions as ae, type SearchActionsConfig as af, type SearchApiClient as ag, type SearchPage as ah, type ShippingActions as ai, type ShippingActionsConfig as aj, type ShippingAddress as ak, type ShippingApiClient as al, type SiteActions as am, type SiteActionsConfig as an, type SlackActions as ao, type SlackActionsConfig as ap, type SlackApiClient as aq, type SmartyStreetsActions as ar, type SmartyStreetsActionsConfig as as, type SmartyStreetsApiClient as at, type UpsActions as au, type UpsActionsConfig as av, type UpsApiClient as aw, type VmiActions as ax, type VmiActionsConfig as ay, type VmiApiClient as az, type AgrInfoActions as b, safeAction as b0, sdkCall as b1, type AgrInfoActionsConfig as c, type AgrInfoApiClient as d, type AgrSiteActions as e, type AgrSiteActionsConfig as f, type AgrSiteApiClient as g, type AgrWorkActions as h, type AgrWorkActionsConfig as i, type AgrWorkApiClient as j, type AvalaraActions as k, type AvalaraActionsConfig as l, type AvalaraApiClient as m, type Basecamp2ActionsConfig as n, type Basecamp2ApiClient as o, type BrandFolderActions as p, type BrandFolderActionsConfig as q, type BrandFolderApiClient as r, type CommerceActionsConfig as s, type CommerceApiClient as t, type CustomerListResult as u, type CustomersActions as v, type CustomersActionsConfig as w, type CustomersApiClient as x, type GregorovichActionsConfig as y, type GregorovichApiClient as z };