@sinequa/atomic 2.1.0 → 2.3.0

package/dist/web-api/helpers/methods/send-request.d.ts

@@ -0,0 +1,24 @@
+import { type AtomicContext } from "../../../client/atomic-context";
+import type { RequestOptions } from "../request-options";
+/**
+ * Issues the request on the context's transport — its `HttpAdapter` when one is configured (SPFx),
+ * the resolved `fetch` otherwise — and hands the response to `handleResponse`.
+ *
+ * On a 401, the configured {@link AuthOptions.recoverFromUnauthorized} hook gets one chance to
+ * re-establish the session; if it succeeds the request is replayed **once**, with the refreshed
+ * CSRF token. Without a hook — or with {@link RequestOptions.noRecovery} — the `UnauthorizedError`
+ * propagates unchanged.
+ *
+ * Centralising this removes the transport branch that used to be copy-pasted in the five verbs.
+ */
+export declare function sendRequest<T>(ctx: AtomicContext, url: string, init: {
+    method: string;
+    headers: Headers;
+    body?: string;
+}, options?: RequestOptions): Promise<T>;
+/**
+ * Builds the JSON body shared by `post`, `put`, `patch` and `del`: the caller's payload plus the
+ * `app`/`locale` context and the two server flags.
+ */
+export declare function buildJsonBody(ctx: AtomicContext, body: Record<string, unknown>, options?: RequestOptions): string;
+//# sourceMappingURL=send-request.d.ts.map

package/dist/web-api/helpers/methods/send-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-request.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/methods/send-request.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAInB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAiEzD;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACzD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CA0BZ;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,CAoBR"}

package/dist/web-api/helpers/request-options.d.ts

@@ -1,18 +1,41 @@
 /**
- * Type définissant les options avancées pour les requêtes HTTP
+ * Options accepted by every HTTP helper (`get`, `post`, `put`, `patch`, `del`).
+ *
+ * All fields are optional, and the set is the same across methods — a request built for one verb
+ * can be moved to another without rewriting its options.
  */
 export interface RequestOptions {
-    /** Headers personnalisés à inclure dans la requête */
+    /** Extra headers to merge into the request. */
     headers?: Headers;
-    /** Type de réponse attendu */
-    responseType?: "arraybuffer" | "blob" | "json" | "text";
-    /** Temps maximum d'attente avant expiration de la requête (en ms) */
-    timeout?: number;
-    /** Signal pour annuler la requête */
-    abortSignal?: AbortSignal;
-    /** Nombre maximum de tentatives en cas d'échec */
-    maxRetries?: number;
-    /** Délai entre les tentatives (en ms) */
-    retryDelay?: number;
+    /**
+     * Expected shape of the response body. Defaults to `"json"`.
+     *
+     * `"response"` hands back the raw response instead of a parsed body, for the callers that need
+     * its headers or status — a download reading `content-disposition`, for instance.
+     */
+    responseType?: "arraybuffer" | "blob" | "json" | "text" | "response";
+    /** Signal used to abort the request (see `createTimeoutController`). */
+    signal?: AbortSignal;
+    /**
+     * How to handle a redirect response. Defaults to the browser's `follow`; pass `"manual"` to avoid
+     * following a cross-origin redirect (e.g. an auth challenge to an IdP), which would otherwise
+     * surface as a CORS network error.
+     */
+    redirect?: RequestRedirect;
+    /**
+     * Overrides the `noAutoAuthentication` flag sent to the server, which otherwise follows the
+     * resolved auth mode (see `resolveNoAutoAuthentication`): `false` in `sso`, so the server can
+     * replay its challenge, `true` everywhere else.
+     */
+    noAutoAuthentication?: boolean;
+    /**
+     * Keeps a `401` on this request from triggering {@link AuthOptions.recoverFromUnauthorized}.
+     *
+     * Set it on every request that is **part of** establishing a session — a sign-in, a session
+     * probe, a logout. Their `401` is an answer, not a session loss, and asking for the session to be
+     * re-established from inside the very procedure that establishes it makes that procedure wait on
+     * itself: the recovery hook never returns, and nothing ever rejects.
+     */
+    noRecovery?: boolean;
 }
 //# sourceMappingURL=request-options.d.ts.map

package/dist/web-api/helpers/request-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-options.d.ts","sourceRoot":"","sources":["../../../src/web-api/helpers/request-options.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACxD,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"request-options.d.ts","sourceRoot":"","sources":["../../../src/web-api/helpers/request-options.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IACrE,wEAAwE;IACxE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/web-api/helpers/utils/build-request-url.d.ts

@@ -0,0 +1,12 @@
+import type { AtomicContext } from "../../../client/atomic-context";
+import type { API_ENDPOINTS } from "../../../types";
+/**
+ * Builds the absolute request URL for an endpoint.
+ *
+ * Endpoints starting with `plugin` get the `api/v1/` prefix (assistant component v3.9.5) — that
+ * rule used to be duplicated in `get`/`post` and simply missing from `put`/`patch`/`del`. When no
+ * `backendUrl` is configured the endpoint stays relative, so the request targets the current origin
+ * instead of `undefined/api/...`.
+ */
+export declare function buildRequestUrl(ctx: AtomicContext, endpoint: API_ENDPOINTS, params?: URLSearchParams): string;
+//# sourceMappingURL=build-request-url.d.ts.map

package/dist/web-api/helpers/utils/build-request-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-request-url.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/utils/build-request-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,aAAa,EACvB,MAAM,CAAC,EAAE,eAAe,GACvB,MAAM,CAQR"}

package/dist/web-api/helpers/utils/{date-utils..d.ts → date-utils.d.ts}

@@ -11,4 +11,4 @@ export declare function toDate(iso?: string): Date | undefined;
 export declare function isExpired(iso?: string): boolean;
 /** Returns true if the given ISO date is within the next N days. */
 export declare function expiresSoon(iso?: string, days?: number): boolean;
-//# sourceMappingURL=date-utils..d.ts.map
+//# sourceMappingURL=date-utils.d.ts.map

package/dist/web-api/helpers/utils/date-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-utils.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/utils/date-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,kDAAkD;AAClD,wBAAgB,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAKrD;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAG/C;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,OAAO,CAS3D"}

package/dist/web-api/helpers/utils/resolve-no-auto-authentication.d.ts

@@ -1,3 +1,4 @@
+import { type AtomicContext } from "../../../client/atomic-context";
 /**
  * Resolves the `noAutoAuthentication` flag sent on data requests.
  *
@@ -12,5 +13,13 @@
  *
  * @returns `false` in `sso` mode (let the server auto-authenticate), `true` otherwise.
  */
+export declare function resolveNoAutoAuthenticationWithContext(ctx: AtomicContext): boolean;
+/**
+ * @returns `false` in `sso` mode (let the server auto-authenticate), `true` otherwise.
+ *
+ * @deprecated Implementation detail of the HTTP helpers, which already apply it to every request.
+ * To override the flag on a single call, pass `noAutoAuthentication` in the request options instead.
+ * It will stop being exported in the next major.
+ */
 export declare function resolveNoAutoAuthentication(): boolean;
 //# sourceMappingURL=resolve-no-auto-authentication.d.ts.map

package/dist/web-api/helpers/utils/resolve-no-auto-authentication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-no-auto-authentication.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/utils/resolve-no-auto-authentication.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAErD"}
+{"version":3,"file":"resolve-no-auto-authentication.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/utils/resolve-no-auto-authentication.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,gCAAgC,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sCAAsC,CACpD,GAAG,EAAE,aAAa,GACjB,OAAO,CAET;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAErD"}

package/dist/web-api/helpers/utils/with-retry.d.ts

@@ -1,9 +1,14 @@
 /**
- * Fonction utilitaire pour effectuer des requêtes avec retry
- * @param fetchFn - Fonction qui exécute la requête fetch
- * @param maxRetries - Nombre maximum de tentatives
- * @param retryDelay - Délai entre les tentatives (en ms)
- * @returns Résultat de la requête
+ * Retries a request until it succeeds or the attempts run out. 4xx responses (except 429) and
+ * aborted requests are never retried.
+ *
+ * @param fetchFn - Function performing the request.
+ * @param maxRetries - Maximum number of retries.
+ * @param retryDelay - Delay between attempts, in ms.
+ * @returns The result of the request.
+ *
+ * @deprecated Never wired into the HTTP helpers, and unused since it was introduced. It will be
+ * removed in the next major; copy it into your application if you rely on it.
  */
 export declare function withRetry<T>(fetchFn: () => Promise<T>, maxRetries?: number, retryDelay?: number): Promise<T>;
 //# sourceMappingURL=with-retry.d.ts.map

package/dist/web-api/helpers/utils/with-retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with-retry.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/utils/with-retry.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,UAAU,GAAE,MAAU,EACtB,UAAU,GAAE,MAAa,GACxB,OAAO,CAAC,CAAC,CAAC,CAmCZ"}
+{"version":3,"file":"with-retry.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/utils/with-retry.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,UAAU,GAAE,MAAU,EACtB,UAAU,GAAE,MAAa,GACxB,OAAO,CAAC,CAAC,CAAC,CAmCZ"}

package/dist/web-api/index.d.ts

@@ -9,12 +9,14 @@ export * from "./v1/fetch-principal";
 export * from "./v1/fetch-query";
 export * from "./v1/fetch-query-export";
 export * from "./v1/fetch-query-intent";
+export * from "./v1/fetch-security-principal";
 export * from "./v1/fetch-similar-documents";
 export * from "./v1/fetch-sponsored-links";
 export * from "./v1/fetch-suggest";
 export * from "./v1/fetch-text-chunk";
 export * from "./v1/fetch-user-settings";
 export * from "./v2/fetch-change-password";
+export * from "./v2/fetch-document-upload-container";
 export * from "./v2/fetch-forgot-password";
 export * from "./v2/fetch-user-profile";
 export * from "./v2/fetch-version";

package/dist/web-api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web-api/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web-api/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC"}

package/dist/web-api/v1/fetch-aggregation.d.ts

@@ -1,3 +1,4 @@
+import { type AtomicContext } from "../../client/atomic-context";
 import { Aggregation, AuditEvents, Query } from "../../types";
 /**
  * Fetches an aggregation from the server.
@@ -7,5 +8,5 @@ import { Aggregation, AuditEvents, Query } from "../../types";
  * @param audit - Optional audit events.
  * @returns A promise that resolves to the fetched aggregation.
  */
-export declare function fetchAggregation(aggregation: Aggregation, query: Query, audit?: AuditEvents): Promise<Aggregation>;
+export declare function fetchAggregation(aggregation: Aggregation, query: Query, audit?: AuditEvents, ctx?: AtomicContext): Promise<Aggregation>;
 //# sourceMappingURL=fetch-aggregation.d.ts.map

package/dist/web-api/v1/fetch-aggregation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-aggregation.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-aggregation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAU,MAAM,aAAa,CAAC;AAItE;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,KAAK,EACZ,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAwBtB"}
+{"version":3,"file":"fetch-aggregation.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-aggregation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAU,MAAM,aAAa,CAAC;AAKtE;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,KAAK,EACZ,KAAK,CAAC,EAAE,WAAW,EACnB,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,WAAW,CAAC,CAwBtB"}

package/dist/web-api/v1/fetch-app.d.ts

@@ -1,20 +1,27 @@
+import { type AtomicContext } from "../../client/atomic-context";
 import type { CCApp, CCAppPreLogin } from "../../types";
 /**
  * Fetches the CCApp object.
- * @param appName - Optional app name to fetch. Defaults to `globalConfig.app` if not provided.
+ * @param appName - Optional app name to fetch. Defaults to the context's `app` if not provided.
+ * @param ctx - Client context to run on. Defaults to the one backing the free functions.
  * @returns A promise that resolves to the CCApp object.
  */
-export declare function fetchApp(appName?: string): Promise<CCApp>;
+export declare function fetchApp(appName?: string, ctx?: AtomicContext): Promise<CCApp>;
 /**
  * Fetches the pre-login information for the app.
+ * @param ctx - Client context to run on. Defaults to the one backing the free functions.
  * @returns A promise that resolves to the pre-login information of the app.
  */
-export declare function fetchAppPreLogin(): Promise<CCAppPreLogin>;
+export declare function fetchAppPreLogin(ctx?: AtomicContext): Promise<CCAppPreLogin>;
 /**
- * Initializes the application configuration by setting the global configuration and fetching app pre-login data.
+ * Resolves the configuration of a context: `backendUrl`/`app` when they can be derived from the
+ * browser URL, then the authentication mode from the server's pre-login response.
+ *
+ * @param ctx - Client context to configure. Defaults to the one backing the free functions, whose
+ *   configuration IS `globalConfig` — so calling it without an argument behaves exactly as before.
  * @returns A promise that resolves when the initialization is complete.
  */
-export declare function initializeAppConfig(): Promise<CCAppPreLogin>;
+export declare function initializeAppConfig(ctx?: AtomicContext): Promise<CCAppPreLogin>;
 /**
  * Initializes the application by setting the global configuration and fetching app pre-login data.
  * @deprecated Use {@link initializeAppConfig} instead.

package/dist/web-api/v1/fetch-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-app.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-app.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIxD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAK/D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CAQ/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,aAAa,CAAC,CA4D5D;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,4BAAsB,CAAC"}
+{"version":3,"file":"fetch-app.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-app.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAInB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGxD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,CAAC,EAAE,MAAM,EAChB,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,KAAK,CAAC,CAKhB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,aAAa,CAAC,CA2DxB;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,4BAAsB,CAAC"}

package/dist/web-api/v1/fetch-audit.d.ts

@@ -1,3 +1,4 @@
+import { type AtomicContext } from "../../client/atomic-context";
 import { AuditEvents, AuditRecord } from "../../types";
 /**
  * Adds additional audit information to the provided body object.
@@ -26,7 +27,7 @@ export declare function addUrl(auditRecord: AuditRecord): AuditRecord;
  * @param addUrl - Whether the url should be automatically added to the request details.
  * @returns A promise that resolves to the updated audit events.
  */
-declare function notify(auditEvents: AuditEvents, addUrl?: boolean): Promise<AuditEvents>;
+declare function notify(auditEvents: AuditEvents, addUrl?: boolean, ctx?: AtomicContext): Promise<AuditEvents>;
 export declare const Audit: {
     notify: typeof notify;
 };

package/dist/web-api/v1/fetch-audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-audit.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-audit.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,WAAW,EAEX,WAAW,EACZ,MAAM,aAAa,CAAC;AAOrB;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,WAAW,GAAE,OAAc,QAU5B;AA2BD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,eASpD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,WAAW,EAAE,WAAW,eAc9C;AAuBD;;;;;;GAMG;AACH,iBAAe,MAAM,CACnB,WAAW,EAAE,WAAW,EACxB,MAAM,GAAE,OAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAStB;AAED,eAAO,MAAM,KAAK;;CAAa,CAAC"}
+{"version":3,"file":"fetch-audit.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-audit.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAEL,WAAW,EAEX,WAAW,EACZ,MAAM,aAAa,CAAC;AAOrB;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,WAAW,GAAE,OAAc,QAU5B;AA2BD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,eASpD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,WAAW,EAAE,WAAW,eAc9C;AAuBD;;;;;;GAMG;AACH,iBAAe,MAAM,CACnB,WAAW,EAAE,WAAW,EACxB,MAAM,GAAE,OAAc,EACtB,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,WAAW,CAAC,CAStB;AAED,eAAO,MAAM,KAAK;;CAAa,CAAC"}

package/dist/web-api/v1/fetch-dataset.d.ts

@@ -1,3 +1,4 @@
+import { type AtomicContext } from "../../client/atomic-context";
 import { Result } from "../../types";
 export type DatasetError = {
     errorCode: number;
@@ -18,7 +19,7 @@ export type DataSet<T extends Result = Result> = Record<string, T | DatasetError
  * @returns {Promise<T>} A promise that resolves to the fetched dataset.
  * @throws {Error} If the dataset contains an error code and message.
  */
-export declare function fetchDataset<T extends Result = Result>(webserviceName: string, datasetName: string, parameters?: {}): Promise<T>;
+export declare function fetchDataset<T extends Result = Result>(webserviceName: string, datasetName: string, parameters?: {}, ctx?: AtomicContext): Promise<T>;
 /**
  * Fetches datasets from a specified web service.
  *
@@ -32,12 +33,12 @@ export declare function fetchDataset<T extends Result = Result>(webserviceName:
 export declare function fetchDatasets<T extends Result = Result>(webserviceName: string, options: {
     parameters?: {};
     datasets?: string[];
-}): Promise<DataSet<T>>;
+}, ctx?: AtomicContext): Promise<DataSet<T>>;
 /**
  * Fetches a list of dataset descriptions from the specified web service.
  *
  * @param webserviceName - The name of the web service to fetch the dataset list from.
  * @returns A promise that resolves to an array of `DatasetDescription` objects.
  */
-export declare function fetchDatasetList(webserviceName: string): Promise<DatasetDescription[]>;
+export declare function fetchDatasetList(webserviceName: string, ctx?: AtomicContext): Promise<DatasetDescription[]>;
 //# sourceMappingURL=fetch-dataset.d.ts.map

package/dist/web-api/v1/fetch-dataset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-dataset.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-dataset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,MAAM,CACrD,MAAM,EACN,CAAC,GAAG,YAAY,CACjB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC1D,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,UAAU,KAAK,GACd,OAAO,CAAC,CAAC,CAAC,CAYZ;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC3D,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE;IAAE,UAAU,CAAC,EAAE,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAChD,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAUrB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAK/B"}
+{"version":3,"file":"fetch-dataset.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-dataset.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,MAAM,CACrD,MAAM,EACN,CAAC,GAAG,YAAY,CACjB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC1D,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,UAAU,KAAK,EACf,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,CAAC,CAAC,CAcZ;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC3D,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE;IAAE,UAAU,CAAC,EAAE,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EACjD,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAUrB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,MAAM,EACtB,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAM/B"}

package/dist/web-api/v1/fetch-labels.d.ts

@@ -1,3 +1,4 @@
+import { type AtomicContext } from "../../client/atomic-context";
 import { LabelsRights, Query } from "../../types";
 /**
  * Fetches all existing labels based on the provided prefix and other optional parameters.
@@ -7,7 +8,7 @@ import { LabelsRights, Query } from "../../types";
  * @param {string} [locale] - Optional locale to filter the labels.
  * @returns {Promise<Labels>} A promise that resolves to the fetched labels.
  */
-export declare function fetchLabels(prefix: string, publicOnly?: boolean, locale?: string): Promise<string[]>;
+export declare function fetchLabels(prefix: string, publicOnly?: boolean, locale?: string, ctx?: AtomicContext): Promise<string[]>;
 /**
  * Fetches the user labels's rights.
  *
@@ -17,7 +18,7 @@ export declare function fetchLabels(prefix: string, publicOnly?: boolean, locale
  *
  * @returns {Promise<LabelsRights>} A promise that resolves to the user rights for the current application.
  */
-declare function getUserRights(): Promise<LabelsRights>;
+declare function getUserRights(ctx?: AtomicContext): Promise<LabelsRights>;
 /**
  * Adds labels to the specified document IDs.
  *
@@ -26,7 +27,7 @@ declare function getUserRights(): Promise<LabelsRights>;
  * @param publicOnly - A boolean indicating whether the labels should be public. Defaults to true.
  * @returns A promise that resolves when the labels have been added.
  */
-declare function add(labels: string[], ids: string[], publicOnly?: boolean): Promise<void>;
+declare function add(labels: string[], ids: string[], publicOnly?: boolean, ctx?: AtomicContext): Promise<void>;
 /**
  * Removes labels from documents.
  *
@@ -35,7 +36,7 @@ declare function add(labels: string[], ids: string[], publicOnly?: boolean): Pro
  * @param {boolean} [publicOnly=true] - Indicates whether the operation should be public only.
  * @returns {Promise<void>} A promise that resolves when the operation is complete.
  */
-declare function remove(labels: string[], ids: string[], publicOnly?: boolean): Promise<void>;
+declare function remove(labels: string[], ids: string[], publicOnly?: boolean, ctx?: AtomicContext): Promise<void>;
 /**
  * Renames a set of labels to a new label.
  *
@@ -44,7 +45,7 @@ declare function remove(labels: string[], ids: string[], publicOnly?: boolean):
  * @param {boolean} [publicOnly=true] - Indicates if the operation should be applied to public labels only.
  * @returns {Promise<void>} A promise that resolves when the operation is complete.
  */
-declare function rename(labels: string[], newLabel: string, publicOnly?: boolean): Promise<void>;
+declare function rename(labels: string[], newLabel: string, publicOnly?: boolean, ctx?: AtomicContext): Promise<void>;
 /**
  * Deletes the specified labels.
  *
@@ -52,7 +53,7 @@ declare function rename(labels: string[], newLabel: string, publicOnly?: boolean
  * @param {boolean} [publicOnly=true] - Indicates whether to delete only public labels. Defaults to true.
  * @returns {Promise<void>} A promise that resolves when the labels have been deleted.
  */
-declare function deleteLabels(labels: string[], publicOnly?: boolean): Promise<void>;
+declare function deleteLabels(labels: string[], publicOnly?: boolean, ctx?: AtomicContext): Promise<void>;
 /**
  * Adds multiple labels in bulk to the specified query.
  *
@@ -61,7 +62,7 @@ declare function deleteLabels(labels: string[], publicOnly?: boolean): Promise<v
  * @param publicOnly - A boolean indicating whether the labels should be public. Defaults to true.
  * @returns A promise that resolves when the labels have been added.
  */
-declare function bulkAdd(labels: string[], query: Query, publicOnly?: boolean): Promise<void>;
+declare function bulkAdd(labels: string[], query: Query, publicOnly?: boolean, ctx?: AtomicContext): Promise<void>;
 /**
  * Removes multiple labels based on the provided query.
  *
@@ -70,7 +71,7 @@ declare function bulkAdd(labels: string[], query: Query, publicOnly?: boolean):
  * @param publicOnly - A boolean indicating whether to remove only public labels. Defaults to true.
  * @returns A promise that resolves when the labels have been removed.
  */
-declare function bulkRemove(labels: string[], query: Query, publicOnly?: boolean): Promise<void>;
+declare function bulkRemove(labels: string[], query: Query, publicOnly?: boolean, ctx?: AtomicContext): Promise<void>;
 /**
  * A collection of functions related to label management.
  *

package/dist/web-api/v1/fetch-labels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-labels.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-labels.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIlE;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,OAAc,EAC1B,MAAM,CAAC,EAAE,MAAM,qBAiBhB;AAED;;;;;;;;GAQG;AACH,iBAAe,aAAa,0BAa3B;AAED;;;;;;;GAOG;AACH,iBAAe,GAAG,CAChB,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE,MAAM,EAAE,EACb,UAAU,GAAE,OAAc,iBAiC3B;AAED;;;;;;;GAOG;AACH,iBAAe,MAAM,CACnB,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE,MAAM,EAAE,EACb,UAAU,GAAE,OAAc,iBAiC3B;AAED;;;;;;;GAOG;AACH,iBAAe,MAAM,CACnB,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,OAAc,iBAuB3B;AAED;;;;;;GAMG;AACH,iBAAe,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,UAAU,GAAE,OAAc,iBAoBvE;AAED;;;;;;;GAOG;AACH,iBAAe,OAAO,CACpB,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,KAAK,EACZ,UAAU,GAAE,OAAc,iBAuB3B;AAED;;;;;;;GAOG;AACH,iBAAe,UAAU,CACvB,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,KAAK,EACZ,UAAU,GAAE,OAAc,iBAuB3B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM;;;;;;;;CAQlB,CAAC"}
+{"version":3,"file":"fetch-labels.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-labels.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAkB,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAKlE;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,OAAc,EAC1B,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,GAAE,aAA8B,qBAqBpC;AAED;;;;;;;;GAQG;AACH,iBAAe,aAAa,CAAC,GAAG,GAAE,aAA8B,yBAa/D;AAED;;;;;;;GAOG;AACH,iBAAe,GAAG,CAChB,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE,MAAM,EAAE,EACb,UAAU,GAAE,OAAc,EAC1B,GAAG,GAAE,aAA8B,iBAiCpC;AAED;;;;;;;GAOG;AACH,iBAAe,MAAM,CACnB,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE,MAAM,EAAE,EACb,UAAU,GAAE,OAAc,EAC1B,GAAG,GAAE,aAA8B,iBAiCpC;AAED;;;;;;;GAOG;AACH,iBAAe,MAAM,CACnB,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,OAAc,EAC1B,GAAG,GAAE,aAA8B,iBAuBpC;AAED;;;;;;GAMG;AACH,iBAAe,YAAY,CACzB,MAAM,EAAE,MAAM,EAAE,EAChB,UAAU,GAAE,OAAc,EAC1B,GAAG,GAAE,aAA8B,iBAqBpC;AAED;;;;;;;GAOG;AACH,iBAAe,OAAO,CACpB,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,KAAK,EACZ,UAAU,GAAE,OAAc,EAC1B,GAAG,GAAE,aAA8B,iBAuBpC;AAED;;;;;;;GAOG;AACH,iBAAe,UAAU,CACvB,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,KAAK,EACZ,UAAU,GAAE,OAAc,EAC1B,GAAG,GAAE,aAA8B,iBAuBpC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM;;;;;;;;CAQlB,CAAC"}

package/dist/web-api/v1/fetch-preview.d.ts

@@ -1,3 +1,4 @@
+import { type AtomicContext } from "../../client/atomic-context";
 import { PreviewData, Query } from "../../types";
 /**
  * Fetches preview data for a given id and query.
@@ -6,7 +7,7 @@ import { PreviewData, Query } from "../../types";
  * @param query - The query parameters for the preview.
  * @returns A promise that resolves to the PreviewData.
  */
-export declare function fetchPreview(id: string, q: Query): Promise<PreviewData>;
+export declare function fetchPreview(id: string, q: Query, ctx?: AtomicContext): Promise<PreviewData>;
 /**
  * Fetches preview document content from a given URL.
  *

package/dist/web-api/v1/fetch-preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-preview.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGjD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,CAsB7E;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,iBAUhD"}
+{"version":3,"file":"fetch-preview.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIjD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,MAAM,EACV,CAAC,EAAE,KAAK,EACR,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,WAAW,CAAC,CAsBtB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,iBAUhD"}

package/dist/web-api/v1/fetch-principal.d.ts

@@ -1,4 +1,6 @@
+import { type AtomicContext } from "../../client/atomic-context";
 import { Principal } from "../../types";
+import type { RequestOptions } from "../helpers/request-options";
 /**
  * Fetches the principal (current user) information from the backend API.
  *
@@ -6,10 +8,12 @@ import { Principal } from "../../types";
  * query parameters to retrieve the current user's data without triggering
  * automatic authentication.
  *
+ * @param options - Request options. `noAutoAuthentication` defaults to the value resolved from the
+ *   context's auth mode; pass `noRecovery` when probing the session from inside a sign-in.
  * @returns A promise that resolves to the Principal object, representing
  *          the current user's information.
  */
-export declare function fetchPrincipal(): Promise<Principal>;
+export declare function fetchPrincipal(options?: RequestOptions, ctx?: AtomicContext): Promise<Principal>;
 type ListOptions = {
     search?: string;
     isuser?: boolean;
@@ -30,7 +34,7 @@ type ListOptions = {
  * const principals = await fetchPrincipalList({ search: "john", isuser: true });
  * ```
  */
-export declare function fetchPrincipalList(options: ListOptions): Promise<Principal[]>;
+export declare function fetchPrincipalList(options: ListOptions, ctx?: AtomicContext): Promise<Principal[]>;
 /**
  * Fetches principal information for a given user ID.
  *
@@ -42,7 +46,7 @@ export declare function fetchPrincipalList(options: ListOptions): Promise<Princi
  * This function performs an API call with automatic authentication disabled.
  * The API endpoint used is "api/v1/principal".
  */
-export declare function fetchPrincipalUserid(userid: string): Promise<Principal>;
+export declare function fetchPrincipalUserid(userid: string, ctx?: AtomicContext): Promise<Principal>;
 /**
  * Fetches principal information for the specified user IDs.
  *
@@ -55,7 +59,7 @@ export declare function fetchPrincipalUserid(userid: string): Promise<Principal>
  * const principals = await fetchPrincipalUserids(['user1', 'user2']);
  * ```
  */
-export declare function fetchPrincipalUserids(userids: string[]): Promise<Principal[]>;
+export declare function fetchPrincipalUserids(userids: string[], ctx?: AtomicContext): Promise<Principal[]>;
 export declare const API: {
     principal: {
         get: typeof fetchPrincipal;

package/dist/web-api/v1/fetch-principal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-principal.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-principal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;;;;;;;;GASG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,SAAS,CAAC,CAOzD;AAED,KAAK,WAAW,GAAG;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,EAAE,CAAC,CAatB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAU7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,SAAS,EAAE,CAAC,CAStB;AAED,eAAO,MAAM,GAAG;;;;;;;CAOf,CAAC"}
+{"version":3,"file":"fetch-principal.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-principal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGjE;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,OAAO,CAAC,EAAE,cAAc,EACxB,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,SAAS,CAAC,CAOpB;AAED,KAAK,WAAW,GAAG;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,WAAW,EACpB,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,SAAS,EAAE,CAAC,CAWtB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,SAAS,CAAC,CAQpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EAAE,EACjB,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,SAAS,EAAE,CAAC,CAQtB;AAED,eAAO,MAAM,GAAG;;;;;;;CAOf,CAAC"}

package/dist/web-api/v1/fetch-query-export.d.ts

@@ -1,3 +1,4 @@
+import { type AtomicContext } from "../../client/atomic-context";
 import { Article, Query } from "../../types";
 import { ExportQueryModel } from "../../types/export/types";
 /**
@@ -15,5 +16,5 @@ export declare function fetchQueryExport({ model, appName, query, article, }: {
     appName: string;
     query: Query;
     article?: Article;
-}): Promise<Response>;
+}, ctx?: AtomicContext): Promise<Response>;
 //# sourceMappingURL=fetch-query-export.d.ts.map

package/dist/web-api/v1/fetch-query-export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-query-export.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-query-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,EACrC,KAAK,EACL,OAAO,EACP,KAAK,EACL,OAAO,GACR,EAAE;IACD,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4BpB"}
+{"version":3,"file":"fetch-query-export.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-query-export.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,EACE,KAAK,EACL,OAAO,EACP,KAAK,EACL,OAAO,GACR,EAAE;IACD,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,EACD,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,QAAQ,CAAC,CAiCnB"}

package/dist/web-api/v1/fetch-query-intent.d.ts

@@ -1,3 +1,4 @@
+import { type AtomicContext } from "../../client/atomic-context";
 import { Query, QueryIntentMatch } from "../../types";
 /**
  * Fetches query intent based on the query.
@@ -9,5 +10,5 @@ import { Query, QueryIntentMatch } from "../../types";
  * @returns A promise that resolves to an array of QueryIntentMatch objects, each
  *          representing a query intent match.
  */
-export declare function fetchQueryIntent(query: Query): Promise<QueryIntentMatch[]>;
+export declare function fetchQueryIntent(query: Query, ctx?: AtomicContext): Promise<QueryIntentMatch[]>;
 //# sourceMappingURL=fetch-query-intent.d.ts.map

package/dist/web-api/v1/fetch-query-intent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-query-intent.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-query-intent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAuB,MAAM,aAAa,CAAC;AAG3E;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAO7B"}
+{"version":3,"file":"fetch-query-intent.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-query-intent.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAuB,MAAM,aAAa,CAAC;AAG3E;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,KAAK,EACZ,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAW7B"}

package/dist/web-api/v1/fetch-query.d.ts

@@ -1,17 +1,18 @@
+import { type AtomicContext } from "../../client/atomic-context";
 import { AuditEvents, Query, QueryIntentData, Result, TreeAggregation, TreeAggregationNode } from "../../types";
 /**
  * Fetches data from the backend using the specified query.
  * @param query The query to be sent to the backend.
  * @returns A promise that resolves to the fetched data.
  */
-export declare function fetchQuery(query: Query, audit?: AuditEvents, queryIntentData?: QueryIntentData): Promise<Result>;
+export declare function fetchQuery(query: Query, audit?: AuditEvents, queryIntentData?: QueryIntentData, ctx?: AtomicContext): Promise<Result>;
 /**
  * Fetches multiple queries in bulk.
  * @param queries - An array of Query objects representing the queries to be fetched.
  * @param auditEvents - Optional AuditEvents object containing audit events for the request.
  * @returns A Promise that resolves to an array of Result objects representing the query results.
  */
-export declare function fetchBulkQuery(queries: Query[], mode?: "parallel", auditEvents?: AuditEvents): Promise<Result[]>;
+export declare function fetchBulkQuery(queries: Query[], mode?: "parallel", auditEvents?: AuditEvents, ctx?: AtomicContext): Promise<Result[]>;
 /**
  * Builds an array of paths and levels for a given tree aggregation.
  *

package/dist/web-api/v1/fetch-query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-query.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-query.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,WAAW,EACX,KAAK,EACL,eAAe,EACf,MAAM,EACN,eAAe,EACf,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAKrB;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,KAAK,EACZ,KAAK,CAAC,EAAE,WAAW,EACnB,eAAe,CAAC,EAAE,eAAe,GAChC,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,KAAK,EAAE,EAChB,IAAI,CAAC,EAAE,UAAU,EACjB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CAiEnB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,eAAe,GAAG,mBAAmB,EAC3C,WAAW,SAAK,EAChB,YAAY,SAAI,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAmBnC"}
+{"version":3,"file":"fetch-query.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-query.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAGL,WAAW,EACX,KAAK,EACL,eAAe,EACf,MAAM,EACN,eAAe,EACf,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAKrB;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,KAAK,EACZ,KAAK,CAAC,EAAE,WAAW,EACnB,eAAe,CAAC,EAAE,eAAe,EACjC,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,MAAM,CAAC,CA+BjB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,KAAK,EAAE,EAChB,IAAI,CAAC,EAAE,UAAU,EACjB,WAAW,CAAC,EAAE,WAAW,EACzB,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,MAAM,EAAE,CAAC,CAyDnB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,eAAe,GAAG,mBAAmB,EAC3C,WAAW,SAAK,EAChB,YAAY,SAAI,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAmBnC"}

package/dist/web-api/v1/fetch-security-principal.d.ts

@@ -0,0 +1,23 @@
+import { type AtomicContext } from "../../client/atomic-context";
+import type { SecurityPrincipalSearchResponse } from "../../types";
+/**
+ * Searches Sinequa principals (users/groups) by free text, via the
+ * `security.principal` endpoint — search-as-you-type for assigning access
+ * (e.g. owners/readers) to a resource. Distinct from `fetchPrincipalList()`
+ * (`api/v1/principal/list`): same idea, different endpoint/response shape.
+ *
+ * @param params - `offset`/`limit` (pagination) and `search` (free-text query).
+ * @param signal - Optional AbortSignal to cancel an in-flight request (e.g.
+ *   a stale keystroke in a debounced search box).
+ *
+ * @example
+ * ```typescript
+ * const results = await searchPrincipals({ offset: 0, limit: 20, search: "john" });
+ * ```
+ */
+export declare function searchPrincipals(params: {
+    offset: number;
+    limit: number;
+    search: string;
+}, signal?: AbortSignal, ctx?: AtomicContext): Promise<SecurityPrincipalSearchResponse>;
+//# sourceMappingURL=fetch-security-principal.d.ts.map

package/dist/web-api/v1/fetch-security-principal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-security-principal.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-security-principal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAGnE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzD,MAAM,CAAC,EAAE,WAAW,EACpB,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,+BAA+B,CAAC,CAE1C"}

package/dist/web-api/v1/fetch-similar-documents.d.ts

@@ -1,3 +1,4 @@
+import { type AtomicContext } from "../../client/atomic-context";
 import { Article } from "../../types";
 /**
  * Fetches similar documents based on the provided document ID and query name.
@@ -7,5 +8,5 @@ import { Article } from "../../types";
  * @param AbortSignal signal - An optional AbortSignal to cancel the request.
  * @returns Article[] Document list detected as similar.
  */
-export declare function fetchSimilarDocuments(documentId: string, queryName: string, signal?: AbortSignal): Promise<Article[]>;
+export declare function fetchSimilarDocuments(documentId: string, queryName: string, signal?: AbortSignal, ctx?: AtomicContext): Promise<Article[]>;
 //# sourceMappingURL=fetch-similar-documents.d.ts.map

package/dist/web-api/v1/fetch-similar-documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-similar-documents.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-similar-documents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,sBAgBrB"}
+{"version":3,"file":"fetch-similar-documents.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-similar-documents.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,EACpB,GAAG,GAAE,aAA8B,sBAepC"}

package/dist/web-api/v1/fetch-sponsored-links.d.ts

@@ -1,3 +1,4 @@
+import { type AtomicContext } from "../../client/atomic-context";
 import { LinkResult, Query } from "../../types";
 /**
  * Fetches sponsored links based on the provided webservice and query.
@@ -10,5 +11,5 @@ import { LinkResult, Query } from "../../types";
  * @returns A promise that resolves to an array of LinkResult objects, each
  *          representing a sponsored link with the original query attached.
  */
-export declare function fetchSponsoredLinks(webservice: string, query: Query): Promise<LinkResult[]>;
+export declare function fetchSponsoredLinks(webservice: string, query: Query, ctx?: AtomicContext): Promise<LinkResult[]>;
 //# sourceMappingURL=fetch-sponsored-links.d.ts.map

package/dist/web-api/v1/fetch-sponsored-links.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-sponsored-links.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-sponsored-links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAgB,KAAK,EAAE,MAAM,aAAa,CAAC;AAG9D;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,UAAU,EAAE,CAAC,CAQvB"}
+{"version":3,"file":"fetch-sponsored-links.d.ts","sourceRoot":"","sources":["../../../src/web-api/v1/fetch-sponsored-links.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAgB,KAAK,EAAE,MAAM,aAAa,CAAC;AAG9D;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,KAAK,EACZ,GAAG,GAAE,aAA8B,GAClC,OAAO,CAAC,UAAU,EAAE,CAAC,CAYvB"}