@simpleapps-com/augur-api 2026.11.2 → 2026.11.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +41 -4
- package/dist/client.d.ts +31 -1
- package/dist/client.d.ts.map +1 -1
- package/dist/core/call.d.ts +2 -2
- package/dist/core/call.d.ts.map +1 -1
- package/dist/core/client-rules.d.ts +122 -0
- package/dist/core/client-rules.d.ts.map +1 -0
- package/dist/core/client.d.ts +25 -4
- package/dist/core/client.d.ts.map +1 -1
- package/dist/core/config.d.ts +24 -0
- package/dist/core/config.d.ts.map +1 -1
- package/dist/core/http-rules.d.ts.map +1 -1
- package/dist/core/site-id-check.d.ts +2 -2
- package/dist/core/site-id.d.ts +3 -3
- package/dist/core/site-id.d.ts.map +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +440 -179
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +440 -179
- package/dist/index.mjs.map +1 -1
- package/dist/services/agr-info/generated/endpoints.d.ts +1 -1
- package/dist/services/agr-info/generated/endpoints.d.ts.map +1 -1
- package/dist/services/agr-int/generated/endpoints.d.ts +1 -1
- package/dist/services/agr-int/generated/endpoints.d.ts.map +1 -1
- package/dist/services/agr-site/generated/endpoints.d.ts +1 -1
- package/dist/services/agr-site/generated/endpoints.d.ts.map +1 -1
- package/dist/services/agr-work/generated/endpoints.d.ts +1 -1
- package/dist/services/agr-work/generated/endpoints.d.ts.map +1 -1
- package/dist/services/avalara/generated/endpoints.d.ts +1 -1
- package/dist/services/avalara/generated/endpoints.d.ts.map +1 -1
- package/dist/services/basecamp2/generated/endpoints.d.ts +1 -1
- package/dist/services/basecamp2/generated/endpoints.d.ts.map +1 -1
- package/dist/services/brand-folder/generated/endpoints.d.ts +1 -1
- package/dist/services/brand-folder/generated/endpoints.d.ts.map +1 -1
- package/dist/services/commerce/generated/endpoints.d.ts +1 -1
- package/dist/services/commerce/generated/endpoints.d.ts.map +1 -1
- package/dist/services/customers/generated/endpoints.d.ts +1 -1
- package/dist/services/customers/generated/endpoints.d.ts.map +1 -1
- package/dist/services/goog-mc/generated/endpoints.d.ts +1 -1
- package/dist/services/goog-mc/generated/endpoints.d.ts.map +1 -1
- package/dist/services/gregorovich/generated/endpoints.d.ts +1 -1
- package/dist/services/gregorovich/generated/endpoints.d.ts.map +1 -1
- package/dist/services/items/generated/endpoints.d.ts +1 -1
- package/dist/services/items/generated/endpoints.d.ts.map +1 -1
- package/dist/services/joomla/generated/endpoints.d.ts +1 -1
- package/dist/services/joomla/generated/endpoints.d.ts.map +1 -1
- package/dist/services/legacy/generated/endpoints.d.ts +1 -1
- package/dist/services/legacy/generated/endpoints.d.ts.map +1 -1
- package/dist/services/logistics/generated/endpoints.d.ts +1 -1
- package/dist/services/logistics/generated/endpoints.d.ts.map +1 -1
- package/dist/services/markets/generated/endpoints.d.ts +1 -1
- package/dist/services/markets/generated/endpoints.d.ts.map +1 -1
- package/dist/services/notifications/generated/endpoints.d.ts +1 -1
- package/dist/services/notifications/generated/endpoints.d.ts.map +1 -1
- package/dist/services/open-search/generated/endpoints.d.ts +1 -1
- package/dist/services/open-search/generated/endpoints.d.ts.map +1 -1
- package/dist/services/orders/generated/endpoints.d.ts +1 -1
- package/dist/services/orders/generated/endpoints.d.ts.map +1 -1
- package/dist/services/p21-apis/generated/endpoints.d.ts +1 -1
- package/dist/services/p21-apis/generated/endpoints.d.ts.map +1 -1
- package/dist/services/p21-core/generated/endpoints.d.ts +1 -1
- package/dist/services/p21-core/generated/endpoints.d.ts.map +1 -1
- package/dist/services/p21-pim/generated/endpoints.d.ts +1 -1
- package/dist/services/p21-pim/generated/endpoints.d.ts.map +1 -1
- package/dist/services/p21-sism/generated/endpoints.d.ts +1 -1
- package/dist/services/p21-sism/generated/endpoints.d.ts.map +1 -1
- package/dist/services/payments/generated/endpoints.d.ts +1 -1
- package/dist/services/payments/generated/endpoints.d.ts.map +1 -1
- package/dist/services/pricing/generated/endpoints.d.ts +1 -1
- package/dist/services/pricing/generated/endpoints.d.ts.map +1 -1
- package/dist/services/shipping/generated/endpoints.d.ts +1 -1
- package/dist/services/shipping/generated/endpoints.d.ts.map +1 -1
- package/dist/services/smarty-streets/generated/endpoints.d.ts +1 -1
- package/dist/services/smarty-streets/generated/endpoints.d.ts.map +1 -1
- package/dist/services/ups/generated/endpoints.d.ts +1 -1
- package/dist/services/ups/generated/endpoints.d.ts.map +1 -1
- package/dist/services/vendors/generated/endpoints.d.ts +1 -1
- package/dist/services/vendors/generated/endpoints.d.ts.map +1 -1
- package/dist/services/vmi/generated/endpoints.d.ts +1 -1
- package/dist/services/vmi/generated/endpoints.d.ts.map +1 -1
- package/package.json +5 -2
package/README.md
CHANGED
|
@@ -88,10 +88,44 @@ const config: AugurAPIConfig = {
|
|
|
88
88
|
};
|
|
89
89
|
const api = new AugurAPI(config);
|
|
90
90
|
|
|
91
|
-
// From context (for framework integration)
|
|
91
|
+
// From context (for framework integration). Options override the context's values, but can't
|
|
92
|
+
// remove its token: that throws ContextCreationError (field "bearerToken").
|
|
92
93
|
const api = AugurAPI.fromContext(context);
|
|
93
94
|
```
|
|
94
95
|
|
|
96
|
+
`timeout` is per attempt: with `retries: 3`, a slow service can hold one call for four
|
|
97
|
+
timeouts plus backoff. `setAuthToken` and `setSiteId` reach every service read from the client
|
|
98
|
+
afterwards; a service object read before the change keeps the old values, so read services from
|
|
99
|
+
the client after a change rather than holding them across it.
|
|
100
|
+
|
|
101
|
+
## Bounding a Call
|
|
102
|
+
|
|
103
|
+
`withRequest` gives a view of the client whose every call is bounded (atlas#106):
|
|
104
|
+
|
|
105
|
+
```typescript
|
|
106
|
+
// The whole call, every retry and the waits between them, within 5 s
|
|
107
|
+
const items = await api.withRequest({ deadline: 5000 }).items.categories.items.list(uid, params);
|
|
108
|
+
|
|
109
|
+
// Or cancel it yourself
|
|
110
|
+
const controller = new AbortController();
|
|
111
|
+
const view = api.withRequest({ signal: controller.signal });
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
- `deadline` (ms) bounds the whole call. Each attempt still has its per-attempt `timeout`, cut to
|
|
115
|
+
what is left. At the deadline the call rejects with a `TimeoutError` DOMException.
|
|
116
|
+
- `signal` cancels the call: the request in flight is aborted and nothing is retried. An
|
|
117
|
+
`AbortSignal.timeout(ms)` signal works the same, rejecting with its `TimeoutError`.
|
|
118
|
+
- The view keeps the client's siteId, token, timeouts, retries and hooks, and sends the same
|
|
119
|
+
headers. It builds its own service clients, so make one view per bounded call.
|
|
120
|
+
- A view of a view keeps every bound: both signals, and the earlier deadline.
|
|
121
|
+
- `withRequest` throws `InvalidArgumentError` for a `signal` that isn't an `AbortSignal` or a
|
|
122
|
+
`deadline` outside 0 to 2147483647 ms (NaN or Infinity included): options can arrive from a
|
|
123
|
+
browser through a server action.
|
|
124
|
+
- An identical GET already in flight on the same client is shared, unless either carries its own
|
|
125
|
+
per-request `signal`: then each runs on its own, so one caller's cancel never ends another's.
|
|
126
|
+
- A server render that awaits a read SHOULD bound it; augur-server's `queryActionWith` does
|
|
127
|
+
this for a method path.
|
|
128
|
+
|
|
95
129
|
## Edge Caching
|
|
96
130
|
|
|
97
131
|
Enable Cloudflare edge caching on any GET request using the `edgeCache` parameter:
|
|
@@ -212,10 +246,12 @@ Developed in the Atlas monorepo (`packages/augur-api`), moved from `simpleapps-c
|
|
|
212
246
|
the type-name ledger `type-names.json`. The repo formatter leaves it alone: it is compared
|
|
213
247
|
byte for byte.
|
|
214
248
|
- Proved with LemmaScript → Dafny: `src/core/site-id-check.ts` (`isSiteId`, the platform's
|
|
215
|
-
site
|
|
249
|
+
siteId rule from `@atlas/auth-core/site`), `src/core/registry-rules.ts` (`hasBodyFor`, `isReadEntry`) and
|
|
216
250
|
`src/core/response-rules.ts` (list metadata normalisation), listed in
|
|
217
251
|
`LemmaScript-files.txt` and linked to `models/AugurApi.dfy`
|
|
218
|
-
(`models/links/augur-api-core-*.dfy`)
|
|
252
|
+
(`models/links/augur-api-core-*.dfy`); `src/core/client-rules.ts` (fromContext's refusals,
|
|
253
|
+
retries under a call's signal, abort names, the call deadline) is linked to
|
|
254
|
+
`models/AugurApiClient.dfy`, the model of the client object (`src/client.ts`). The path-segment checks (`hasLoneSurrogate`,
|
|
219
255
|
`isEncoded`) and the service id rule (`kebabCamel`, shared with the generator) are proved in
|
|
220
256
|
`@atlas/utils` (`uri`, `case`) and bundled into the build. The rest of the client's decisions are modelled in
|
|
221
257
|
`models/AugurApi.dfy`, and the generator's in `models/AugurApiGen.dfy`, ahead of their proofs.
|
|
@@ -233,7 +269,8 @@ pnpm smoke:workerd # after build: the bundle in workerd, endpoints() and one
|
|
|
233
269
|
```
|
|
234
270
|
|
|
235
271
|
The live suites in `tests/e2e/` read credentials from the Atlas project's `.simpleapps/` and
|
|
236
|
-
are not part of the gates.
|
|
272
|
+
are not part of the gates. `pnpm -C repo/packages/augur-api live:bounded` checks bounded calls
|
|
273
|
+
(`withRequest`) against the real services, read-only. The story CLI (`tests/e2e/stories/run-json-story.ts`) has no
|
|
237
274
|
TypeScript runner in Atlas yet (augur-api ran it with ts-node).
|
|
238
275
|
|
|
239
276
|
## Deployment
|
package/dist/client.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { type CallArgs, type CallResult } from "./core/call";
|
|
2
|
-
import { type AugurAPIConfig, type AugurContext } from "./core/config";
|
|
2
|
+
import { type AugurAPIConfig, type AugurContext, type CallOptions } from "./core/config";
|
|
3
3
|
import { type EndpointEntry } from "./core/registry";
|
|
4
4
|
import { JoomlaClient } from "./services/joomla";
|
|
5
5
|
import { CommerceClient } from "./services/commerce";
|
|
@@ -116,6 +116,8 @@ export type { AugurContext } from "./core/config";
|
|
|
116
116
|
*/
|
|
117
117
|
export declare class AugurAPI {
|
|
118
118
|
private config;
|
|
119
|
+
/** This client's call bounds: none, unless it is a view from `withRequest`. */
|
|
120
|
+
private bounds;
|
|
119
121
|
private _joomla?;
|
|
120
122
|
private _commerce?;
|
|
121
123
|
private _pricing?;
|
|
@@ -173,6 +175,26 @@ export declare class AugurAPI {
|
|
|
173
175
|
* ```
|
|
174
176
|
*/
|
|
175
177
|
call(id: string, args?: CallArgs): Promise<CallResult>;
|
|
178
|
+
/**
|
|
179
|
+
* A view of this client whose every call is bounded by `options` (atlas#106): the caller's
|
|
180
|
+
* `signal`, and a `deadline` in milliseconds for the whole call, retries and the waits between
|
|
181
|
+
* them included. The view has this client's siteId, token, timeouts, retries and hooks, sends
|
|
182
|
+
* the same headers, and builds its own service clients (sharing no in-flight request with this
|
|
183
|
+
* one). Building a view and its first service costs about what building this client did, so
|
|
184
|
+
* make one per bounded call, not per request inside a loop.
|
|
185
|
+
*
|
|
186
|
+
* @example
|
|
187
|
+
* ```typescript
|
|
188
|
+
* const items = await api.withRequest({ deadline: 5000 }).items.categories.items.list(uid, params);
|
|
189
|
+
* ```
|
|
190
|
+
*
|
|
191
|
+
* @throws InvalidArgumentError when `signal` is given but not an AbortSignal, or `deadline` is
|
|
192
|
+
* given but not a number from 0 to 2147483647 (NaN, Infinity or larger would fire at once).
|
|
193
|
+
* Options can come from a browser through a server action, so their shape is checked.
|
|
194
|
+
*/
|
|
195
|
+
withRequest(options: CallOptions): AugurAPI;
|
|
196
|
+
/** The HTTP client a service is built with: this client's config and call bounds. */
|
|
197
|
+
private httpFor;
|
|
176
198
|
/**
|
|
177
199
|
* Create AugurAPI client from context object
|
|
178
200
|
*
|
|
@@ -321,11 +343,19 @@ export declare class AugurAPI {
|
|
|
321
343
|
get basecamp2(): Basecamp2Client;
|
|
322
344
|
/**
|
|
323
345
|
* Update authentication token
|
|
346
|
+
*
|
|
347
|
+
* Every service read from this client afterwards (`api.items`, …) sends the new token. A
|
|
348
|
+
* service object read BEFORE the change keeps the token it was built with: read services from
|
|
349
|
+
* the client after a change, don't hold them across it (AugurApiClient.BuiltClientKeepsItsSnapshot).
|
|
350
|
+
*
|
|
324
351
|
* @param bearerToken New bearer token
|
|
325
352
|
*/
|
|
326
353
|
setAuthToken(bearerToken: string): void;
|
|
327
354
|
/**
|
|
328
355
|
* Update site ID
|
|
356
|
+
*
|
|
357
|
+
* As with `setAuthToken`: a service object read before the change keeps the old siteId.
|
|
358
|
+
*
|
|
329
359
|
* @param siteId New site ID
|
|
330
360
|
* @throws InvalidArgumentError when it is not a siteId (see the constructor)
|
|
331
361
|
*/
|
package/dist/client.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
package/dist/core/call.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type
|
|
1
|
+
import { type AugurAPIConfig, type CallBounds } from "./config";
|
|
2
2
|
import { type EndpointEntry } from "./registry";
|
|
3
3
|
/** What `call()` sends. Keys are sent as given; there is no case renaming. */
|
|
4
4
|
export interface CallArgs {
|
|
@@ -44,5 +44,5 @@ export declare function fillPath(entry: EndpointEntry, pathParams: Record<string
|
|
|
44
44
|
* @throws InvalidArgumentError before any I/O when the id is unknown or `args` break checkArgs
|
|
45
45
|
* @throws AugurError subclasses for non-2xx and network failures, with `endpoint` = entry.path
|
|
46
46
|
*/
|
|
47
|
-
export declare function callEndpoint(config: AugurAPIConfig, id: string, args?: CallArgs): Promise<CallResult>;
|
|
47
|
+
export declare function callEndpoint(config: AugurAPIConfig, id: string, args?: CallArgs, bounds?: CallBounds): Promise<CallResult>;
|
|
48
48
|
//# sourceMappingURL=call.d.ts.map
|
package/dist/core/call.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../src/core/call.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../src/core/call.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAa,MAAM,UAAU,CAAC;AAK3E,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEjE,8EAA8E;AAC9E,MAAM,WAAW,QAAQ;IACvB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC7C,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,sCAAsC;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,iFAAiF;AACjF,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,sBAAsB;AACtB,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,8EAA8E;IAC9E,IAAI,EAAE,OAAO,CAAC;CACf;AA8DD;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAC1C,MAAM,CAQR;AAcD;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,QAAa,EACnB,MAAM,GAAE,UAAsB,GAC7B,OAAO,CAAC,UAAU,CAAC,CAiBrB"}
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
/** What fromContext refuses, if anything. */
|
|
2
|
+
export type ContextRefusal = "ok" | "context" | "site-id" | "token" | "token-removed";
|
|
3
|
+
/**
|
|
4
|
+
* fromContext's own refusals, in order: no context; no siteId; no jwt or bearerToken in the
|
|
5
|
+
* context; options that removed the context's token. The siteId's shape is the constructor's.
|
|
6
|
+
*
|
|
7
|
+
* @ensures exactly the model's ContextRefusalOf
|
|
8
|
+
*/
|
|
9
|
+
export declare function contextRefusalOf(hasContext: boolean, siteIdTruthy: boolean, contextTokenTruthy: boolean, finalTokenTruthy: boolean): ContextRefusal;
|
|
10
|
+
/**
|
|
11
|
+
* An error worth retrying: anything but an AugurError whose status is final (`isRetryableError`).
|
|
12
|
+
*
|
|
13
|
+
* @ensures exactly the model's Retryable
|
|
14
|
+
*/
|
|
15
|
+
export declare function retryableError(isAugurError: boolean, status: number): boolean;
|
|
16
|
+
/**
|
|
17
|
+
* Attempt `attempt` (from 0) is retried while attempts remain and the error is retryable, and
|
|
18
|
+
* never once the call's own signal (the caller's, or its deadline) has fired: decided from the
|
|
19
|
+
* call signal, not the error, since the client's per-attempt timer raises an AbortError too.
|
|
20
|
+
*
|
|
21
|
+
* @ensures exactly the model's RetryAfterCall
|
|
22
|
+
*/
|
|
23
|
+
export declare function retryAfterCall(attempt: number, retries: number, retryable: boolean, callAborted: boolean): boolean;
|
|
24
|
+
/**
|
|
25
|
+
* The DOMException names an abort surfaces as, rethrown as they are: AbortError, and TimeoutError
|
|
26
|
+
* (an `AbortSignal.timeout` signal's).
|
|
27
|
+
*
|
|
28
|
+
* @ensures exactly the model's IsAbortName
|
|
29
|
+
*/
|
|
30
|
+
export declare function isAbortName(name: string): boolean;
|
|
31
|
+
/**
|
|
32
|
+
* What is left of a deadline after `elapsed` ms, never negative.
|
|
33
|
+
*
|
|
34
|
+
* @ensures exactly the model's RemainingOf
|
|
35
|
+
*/
|
|
36
|
+
export declare function remainingOf(deadline: number, elapsed: number): number;
|
|
37
|
+
/**
|
|
38
|
+
* An attempt's timeout: the per-attempt timeout, cut to what is left of the deadline when there
|
|
39
|
+
* is one.
|
|
40
|
+
*
|
|
41
|
+
* @ensures exactly the model's AttemptTimeoutOf
|
|
42
|
+
*/
|
|
43
|
+
export declare function attemptTimeoutOf(perAttempt: number, hasDeadline: boolean, remaining: number): number;
|
|
44
|
+
/**
|
|
45
|
+
* The wait before a retry: the backoff, cut to what is left of the deadline when there is one.
|
|
46
|
+
*
|
|
47
|
+
* @ensures exactly the model's WaitOf
|
|
48
|
+
*/
|
|
49
|
+
export declare function waitOf(backoff: number, hasDeadline: boolean, remaining: number): number;
|
|
50
|
+
/**
|
|
51
|
+
* Whether an attempt sets its own timer: only when its per-attempt timeout ends before the
|
|
52
|
+
* deadline. When the deadline is as tight or tighter, the call's one deadline timer cuts the
|
|
53
|
+
* attempt (with a TimeoutError); a second timer for the same instant could fire first and end the
|
|
54
|
+
* call with a bare AbortError.
|
|
55
|
+
*
|
|
56
|
+
* @ensures exactly the model's NeedsAttemptTimer
|
|
57
|
+
*/
|
|
58
|
+
export declare function needsAttemptTimer(perAttempt: number, hasDeadline: boolean, remaining: number): boolean;
|
|
59
|
+
/**
|
|
60
|
+
* A call is bounded (gets a scope with a signal) when it has a signal or a deadline.
|
|
61
|
+
*
|
|
62
|
+
* @ensures exactly the model's BoundedCall
|
|
63
|
+
*/
|
|
64
|
+
export declare function boundedCall(hasSignal: boolean, hasDeadline: boolean): boolean;
|
|
65
|
+
/**
|
|
66
|
+
* A deadline setTimeout keeps: 0 to 2^31 − 1 ms. At runtime NaN fails both comparisons and
|
|
67
|
+
* Infinity the second; setTimeout would fire either (or anything larger) at once.
|
|
68
|
+
*
|
|
69
|
+
* @ensures exactly the model's DeadlineInRange
|
|
70
|
+
*/
|
|
71
|
+
export declare function deadlineInRange(deadline: number): boolean;
|
|
72
|
+
/**
|
|
73
|
+
* The call options `withRequest` accepts: a signal, when given, an AbortSignal; a deadline, when
|
|
74
|
+
* given, in range. A server action can carry any JSON from the browser, so the shape is checked.
|
|
75
|
+
*
|
|
76
|
+
* @ensures exactly the model's CallOptionsAccepted
|
|
77
|
+
*/
|
|
78
|
+
export declare function callOptionsAccepted(hasSignal: boolean, isAbortSignal: boolean, hasDeadline: boolean, inRange: boolean): boolean;
|
|
79
|
+
/**
|
|
80
|
+
* Whether a GET joins an identical one already in flight: only when it carries no per-request
|
|
81
|
+
* signal. A joined call shares the first call's signal, so one of its own could neither cancel it
|
|
82
|
+
* nor be kept from cancelling the other caller.
|
|
83
|
+
*
|
|
84
|
+
* @ensures exactly the model's SharesInFlight
|
|
85
|
+
*/
|
|
86
|
+
export declare function sharesInFlight(hasRequestSignal: boolean): boolean;
|
|
87
|
+
/**
|
|
88
|
+
* The deadline of a view made from a view: the earlier of the two (both run from the call's
|
|
89
|
+
* start), or the one given when only one is. Read only when `hasMergedDeadline`.
|
|
90
|
+
*
|
|
91
|
+
* @ensures exactly the model's MergedDeadline (with `hasMergedDeadline`)
|
|
92
|
+
*/
|
|
93
|
+
export declare function mergedDeadlineOf(hasOuter: boolean, outer: number, hasInner: boolean, inner: number): number;
|
|
94
|
+
/**
|
|
95
|
+
* Whether a view made from a view has a deadline: when either does.
|
|
96
|
+
*
|
|
97
|
+
* @ensures with mergedDeadlineOf, exactly the model's MergedDeadline
|
|
98
|
+
*/
|
|
99
|
+
export declare function hasMergedDeadline(hasOuter: boolean, hasInner: boolean): boolean;
|
|
100
|
+
/** How an `edgeCache` value travels. */
|
|
101
|
+
export type EdgeCacheKind = "sub-hour" | "hourly" | "invalid";
|
|
102
|
+
/**
|
|
103
|
+
* An `edgeCache` value's kind (transformEdgeCacheParams): a sub-hour text ("30s", "1m", "5m")
|
|
104
|
+
* travels as itself; an hourly value (1, 2, 3, 4, 5 or 8, as `parseInt(text, 10)` reads it, given
|
|
105
|
+
* as `hours`) as its number; anything else is dropped. NaN matches no hour.
|
|
106
|
+
*
|
|
107
|
+
* @ensures exactly the model's EdgeCacheKindOf
|
|
108
|
+
*/
|
|
109
|
+
export declare function edgeCacheKindOf(text: string, hours: number): EdgeCacheKind;
|
|
110
|
+
/**
|
|
111
|
+
* `raw()` retries a GET like `get()`; anything else makes one attempt.
|
|
112
|
+
*
|
|
113
|
+
* @ensures exactly the model's RawRetries
|
|
114
|
+
*/
|
|
115
|
+
export declare function rawRetries(method: string): boolean;
|
|
116
|
+
/**
|
|
117
|
+
* Whether an attempt starts: always with no deadline, else only while some of it is left.
|
|
118
|
+
*
|
|
119
|
+
* @ensures exactly the model's StartsAttempt
|
|
120
|
+
*/
|
|
121
|
+
export declare function startsAttempt(hasDeadline: boolean, remaining: number): boolean;
|
|
122
|
+
//# sourceMappingURL=client-rules.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client-rules.d.ts","sourceRoot":"","sources":["../../src/core/client-rules.ts"],"names":[],"mappings":"AAQA,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,eAAe,CAAC;AAEtF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,OAAO,EACnB,YAAY,EAAE,OAAO,EACrB,kBAAkB,EAAE,OAAO,EAC3B,gBAAgB,EAAE,OAAO,GACxB,cAAc,CAWhB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAI7E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,EAClB,WAAW,EAAE,OAAO,GACnB,OAAO,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIrE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,MAAM,GAChB,MAAM,CAIR;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAIvF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAIT;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAI7E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIzD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,OAAO,EAClB,aAAa,EAAE,OAAO,EACtB,WAAW,EAAE,OAAO,EACpB,OAAO,EAAE,OAAO,GACf,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAIjE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,MAAM,GACZ,MAAM,CAQR;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAI/E;AAED,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAS1E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAIlD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAI9E"}
|
package/dist/core/client.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type AugurAPIConfig, type RequestConfig } from "./config";
|
|
1
|
+
import { type AugurAPIConfig, type CallBounds, type RequestConfig } from "./config";
|
|
2
2
|
/** A response as text, before any JSON parsing (what `call()` builds its result from). */
|
|
3
3
|
export interface RawResponse {
|
|
4
4
|
status: number;
|
|
@@ -24,9 +24,12 @@ export declare class HTTPClient {
|
|
|
24
24
|
private config;
|
|
25
25
|
private serviceName;
|
|
26
26
|
private inflightRequests;
|
|
27
|
-
|
|
27
|
+
private bounds;
|
|
28
|
+
/** `bounds` bound every call this client makes (a view's, from `AugurAPI.withRequest`). */
|
|
29
|
+
constructor(serviceName: string, config: AugurAPIConfig, bounds?: CallBounds);
|
|
28
30
|
/**
|
|
29
|
-
* Build request headers with auth
|
|
31
|
+
* Build request headers with auth. A request's own headers come before `x-site-id` and
|
|
32
|
+
* `Authorization`, so neither can be replaced by one (AugurApiClient.SiteIdHeaderIsTheClients).
|
|
30
33
|
*/
|
|
31
34
|
private buildRequestHeaders;
|
|
32
35
|
/**
|
|
@@ -46,12 +49,23 @@ export declare class HTTPClient {
|
|
|
46
49
|
* the result, inside the same error handling and timeout as the fetch.
|
|
47
50
|
*/
|
|
48
51
|
private request;
|
|
52
|
+
/**
|
|
53
|
+
* An attempt's timeout (the per-attempt one, cut to what is left of the call's deadline: what
|
|
54
|
+
* the onRequest hook sees) and whether it sets its own timer: only when it ends before the
|
|
55
|
+
* deadline; otherwise the call's one deadline timer cuts it, with a TimeoutError
|
|
56
|
+
* (client-rules.ts; AugurApiClient.OneTimerCutsEachAttempt).
|
|
57
|
+
*/
|
|
58
|
+
private attemptBounds;
|
|
59
|
+
/** The signal one attempt is sent with, and how to clear its timer and listeners after. */
|
|
60
|
+
private attemptSignal;
|
|
49
61
|
/** The request's timeout: per request, else the client's, else the default (timeoutOf). */
|
|
50
62
|
private timeoutFor;
|
|
51
63
|
/** The request as the `onRequest` hook receives it. */
|
|
52
64
|
private baseRequest;
|
|
53
65
|
/**
|
|
54
|
-
* Merge
|
|
66
|
+
* Merge the call's signal and an attempt's timer: aborts when either fires, with that one's
|
|
67
|
+
* reason. `dispose` removes the listener from the call's signal, which outlives the attempt
|
|
68
|
+
* (one per attempt would pile up on a long-lived caller signal).
|
|
55
69
|
*/
|
|
56
70
|
private mergeSignals;
|
|
57
71
|
/**
|
|
@@ -71,10 +85,17 @@ export declare class HTTPClient {
|
|
|
71
85
|
* Executes a single request attempt
|
|
72
86
|
*/
|
|
73
87
|
private executeAttempt;
|
|
88
|
+
/**
|
|
89
|
+
* One attempt, started only while the call's deadline has time left (client-rules.ts
|
|
90
|
+
* startsAttempt); past it the call rejects with a TimeoutError.
|
|
91
|
+
*/
|
|
92
|
+
private attemptWithin;
|
|
74
93
|
/**
|
|
75
94
|
* Executes a request with retry logic
|
|
76
95
|
*/
|
|
77
96
|
private executeWithRetry;
|
|
97
|
+
/** Runs `fn` in a fresh call scope and disposes it, however `fn` settles. */
|
|
98
|
+
private withinCall;
|
|
78
99
|
/**
|
|
79
100
|
* Transform edgeCache parameter to Cloudflare's cacheSiteId format
|
|
80
101
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EAInB,KAAK,UAAU,EAGf,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAiClB,0FAA0F;AAC1F,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AASD,mGAAmG;AACnG,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAMlD;AAyCD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAIxF;AAqKD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAA4C;IACpE,OAAO,CAAC,MAAM,CAAa;IAE3B,2FAA2F;gBAC/E,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAE,UAAsB;IAMvF;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;YACW,gBAAgB;IA+B9B;;OAEG;YACW,kBAAkB;IAsBhC;;OAEG;YACW,OAAO;IAqBrB;;;OAGG;YACW,OAAO;IAuCrB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAYrB,2FAA2F;IAC3F,OAAO,CAAC,aAAa;IAoBrB,2FAA2F;IAC3F,OAAO,CAAC,UAAU;IAYlB,uDAAuD;IACvD,OAAO,CAAC,WAAW;IAgBnB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAmBpB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;YACW,cAAc;IAgC5B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;YACW,gBAAgB;IAO9B,6EAA6E;YAC/D,UAAU;IAYxB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,wBAAwB;IAkC1B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAqCzE,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAO1F,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAOzF,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAOlF;;;;;OAKG;IACG,GAAG,CACP,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,aAAa,CAAA;KAAO,GACzE,OAAO,CAAC,WAAW,CAAC;CAYxB"}
|
package/dist/core/config.d.ts
CHANGED
|
@@ -40,6 +40,30 @@ export interface RequestConfig {
|
|
|
40
40
|
/** Path template reported as `endpoint` in errors, e.g. `/inv-mast/{invMastUid}` */
|
|
41
41
|
endpoint?: string;
|
|
42
42
|
}
|
|
43
|
+
/**
|
|
44
|
+
* Bounds every call made through a client view (`api.withRequest(options)`, atlas#106).
|
|
45
|
+
*
|
|
46
|
+
* - `signal`: the caller's own abort. Once it fires the call stops: the request in flight is
|
|
47
|
+
* cancelled and no retry follows (an `AbortSignal.timeout` signal's `TimeoutError` included).
|
|
48
|
+
* - `deadline`: milliseconds for the WHOLE call, every attempt and every wait between retries
|
|
49
|
+
* together. Not the per-attempt `timeout` (30 s by default), which still applies to each
|
|
50
|
+
* attempt, cut to what is left of the deadline. At the deadline the call rejects with a
|
|
51
|
+
* `TimeoutError` DOMException.
|
|
52
|
+
*/
|
|
53
|
+
export interface CallOptions {
|
|
54
|
+
signal?: AbortSignal;
|
|
55
|
+
deadline?: number;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* A client's call bounds, inside the SDK (not exported): every signal the view and the views it
|
|
59
|
+
* was made from were given, and the tightest deadline (AugurApiClient.Bounds). A plain client
|
|
60
|
+
* has none.
|
|
61
|
+
*/
|
|
62
|
+
export interface CallBounds {
|
|
63
|
+
signals: readonly AbortSignal[];
|
|
64
|
+
deadline?: number;
|
|
65
|
+
}
|
|
66
|
+
export declare const NO_BOUNDS: CallBounds;
|
|
43
67
|
export declare const DEFAULT_CONFIG: {
|
|
44
68
|
timeout: number;
|
|
45
69
|
retries: number;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"http-rules.d.ts","sourceRoot":"","sources":["../../src/core/http-rules.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"http-rules.d.ts","sourceRoot":"","sources":["../../src/core/http-rules.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAIzD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAOtE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAKR;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAIrD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAInE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAIvE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI9E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAIrD"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @ensures result =
|
|
3
|
-
* string, never a prefix
|
|
2
|
+
* @ensures result = the platform's isSiteId(s) — non-empty, every character in [a-z0-9_-],
|
|
3
|
+
* the whole string, never a prefix
|
|
4
4
|
*/
|
|
5
5
|
export declare function isSiteId(s: string): boolean;
|
|
6
6
|
//# sourceMappingURL=site-id-check.d.ts.map
|
package/dist/core/site-id.d.ts
CHANGED
|
@@ -1,15 +1,15 @@
|
|
|
1
|
-
declare const siteIdBrand: unique symbol;
|
|
2
1
|
/**
|
|
3
2
|
* A siteId that passed `isSiteId`. The only ways to get one are `parseSiteId` and `assertSiteId`
|
|
4
3
|
* below, so a function that takes a `SiteId` cannot be handed a raw, empty or malformed string.
|
|
5
4
|
* The compiler checks that. (`AugurAPIConfig.siteId` stays a plain `string`, validated at runtime.)
|
|
5
|
+
* The brand is the platform's (`@atlas/auth-core/site` `SiteId`, the same string-keyed shape,
|
|
6
|
+
* written here so the published types name no private package): one SiteId type everywhere.
|
|
6
7
|
*/
|
|
7
8
|
export type SiteId = string & {
|
|
8
|
-
readonly
|
|
9
|
+
readonly __siteId: true;
|
|
9
10
|
};
|
|
10
11
|
/** The branded siteId, or `undefined` when `value` is not one. The one cast in the package is here. */
|
|
11
12
|
export declare function parseSiteId(value: string): SiteId | undefined;
|
|
12
13
|
/** The branded siteId, or an `InvalidArgumentError` that does not echo the value. */
|
|
13
14
|
export declare function assertSiteId(value: string): SiteId;
|
|
14
|
-
export {};
|
|
15
15
|
//# sourceMappingURL=site-id.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"site-id.d.ts","sourceRoot":"","sources":["../../src/core/site-id.ts"],"names":[],"mappings":"AAOA
|
|
1
|
+
{"version":3,"file":"site-id.d.ts","sourceRoot":"","sources":["../../src/core/site-id.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAA;CAAE,CAAC;AAE1D,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7D;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWlD"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
export declare const VERSION = "2026.11.
|
|
1
|
+
export declare const VERSION = "2026.11.4";
|
|
2
2
|
export { AugurAPI } from "./client";
|
|
3
3
|
export { authenticateUserForSite, createCrossSiteAuthenticator, type CrossSiteAuthParams, type CrossSiteAuthResult, } from "./utils/cross-site-auth";
|
|
4
|
-
export { type AugurAPIConfig, type AugurRequestConfig, type AugurResponse, type AugurRequestError, type RequestConfig, type AugurContext, ContextCreationError, } from "./core/config";
|
|
4
|
+
export { type AugurAPIConfig, type AugurRequestConfig, type AugurResponse, type AugurRequestError, type RequestConfig, type CallOptions, type AugurContext, ContextCreationError, } from "./core/config";
|
|
5
5
|
export { type AugurAPIError, AugurError, ValidationError, AuthenticationError, NotFoundError, RateLimitError, InvalidArgumentError, } from "./core/errors";
|
|
6
6
|
export { BaseResponseSchema, HealthCheckDataSchema, PaginationParamsSchema, WhoamiDataSchema, type BaseResponse, type HealthCheckData, type Known, type PingData, type WhoamiData, } from "./core/schemas";
|
|
7
7
|
export { type EndpointEntry, type EndpointParam, isReadOnly } from "./core/registry";
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|