@sinequa/atomic 2.2.0 → 2.3.0

package/dist/types/search/Result.d.ts

@@ -1,3 +1,4 @@
+import type { ApiError } from "../../web-api/helpers/errors/api-error";
 import { Aggregation, TreeAggregation } from "../aggregations";
 import { Answer } from "./Answer";
 import { Article } from "./Article";
@@ -8,7 +9,13 @@ import { QueryIntent } from "./QueryIntent";
 import { Tab } from "./Tab";
 import { TopPassage } from "./TopPassage";
 /**
- * Describes the results of a call to the query web service
+ * Describes the results of a **search** call to the query web service.
+ *
+ * Only a search response has this shape. A query sent with `action: "aggregate"` — the one that pages
+ * through a single aggregation's items — comes back with `aggregations` and little else: no `records`,
+ * no `rowCount`, no `page`/`pageSize`, no `tab`. Type those responses as {@link AggregateResult}
+ * instead; casting one to `Result` makes twelve absent fields look present, and arithmetic on them
+ * silently yields `NaN` rather than failing.
  */
 export type Result = {
     id: string;
@@ -26,7 +33,8 @@ export type Result = {
     didYouMean?: DidYouMean;
     aggregations: (Aggregation | TreeAggregation)[];
     attributes: Attributes;
-    queryIntents: QueryIntent[];
+    /** Absent unless the query carried a query-intent configuration — the server omits the key entirely. */
+    queryIntents?: QueryIntent[];
     queryAnalysis?: QueryAnalysis;
     records: Article[];
     rfmQueryHash?: string;
@@ -39,5 +47,31 @@ export type Result = {
     topPassages?: {
         passages?: TopPassage[];
     } | null;
+    /**
+     * Set by the client, never by the server: the request failed, and none of the fields above were
+     * received.
+     *
+     * It exists so a failure can be told apart from a corpus that legitimately matched nothing. Both
+     * arrive as a result with no records, and a caller that only looks at `records` or `rowCount` reports
+     * "no results" for a backend that is in fact broken — a 500 on a malformed filter, typically. Check
+     * this field **before** concluding anything from an empty result.
+     *
+     * Prefixed with `$` like the other client-side additions (`$hasMore`, `$selected`).
+     */
+    $error?: ApiError;
+};
+/**
+ * Describes the response to a query sent with `action: "aggregate"` — paging through one
+ * aggregation's items, as a "load more" does.
+ *
+ * A deliberately narrow type: the server answers with these four keys and nothing else of use. It is
+ * **not** a {@link Result}, and typing it as one is how `rowCount`, `records` and `page` came to be read
+ * from a response that never carries them.
+ */
+export type AggregateResult = {
+    id: string;
+    queryName: string;
+    aggregations: (Aggregation | TreeAggregation)[];
+    attributes: Attributes;
 };
 //# sourceMappingURL=Result.d.ts.map

package/dist/types/search/Result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Result.d.ts","sourceRoot":"","sources":["../../../src/types/search/Result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,EAAE,CAAC,WAAW,GAAG,eAAe,CAAC,EAAE,CAAC;IAChD,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,GAAG,IAAI,CAAC;IACT,WAAW,CAAC,EAAE;QACZ,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;KACzB,GAAG,IAAI,CAAC;CACV,CAAC"}
+{"version":3,"file":"Result.d.ts","sourceRoot":"","sources":["../../../src/types/search/Result.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,EAAE,CAAC,WAAW,GAAG,eAAe,CAAC,EAAE,CAAC;IAChD,UAAU,EAAE,UAAU,CAAC;IACvB,wGAAwG;IACxG,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,GAAG,IAAI,CAAC;IACT,WAAW,CAAC,EAAE;QACZ,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;KACzB,GAAG,IAAI,CAAC;IACT;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,CAAC,WAAW,GAAG,eAAe,CAAC,EAAE,CAAC;IAChD,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC"}

package/dist/types/search/index.d.ts

@@ -24,7 +24,7 @@ export type { QueryIntentMatch } from "./QueryIntentMatch";
 export type { QueryIntentResponse } from "./QueryIntentResponse";
 export type { QueryIntentWord } from "./QueryIntentWord";
 export type { RelevantExtract } from "./RelevantExtract";
-export type { Result } from "./Result";
+export type { AggregateResult, Result } from "./Result";
 export type { RFMActionDisplay } from "./RFMActionDisplay";
 export type { RFMData } from "./RFMData";
 export { RFMDisplay } from "./RFMDisplay";

package/dist/types/search/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/search/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,EAAE,CAAC;CACd;AAED,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAC7E,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/search/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,EAAE,CAAC;CACd;AAED,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAC7E,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/utils/logger.d.ts

@@ -15,26 +15,37 @@ interface LoggerConfig {
     level: LogLevel;
     enableConsoleOutput: boolean;
 }
+/** Signature of the exported log functions. */
+type LogFn = (message: string, data?: unknown) => void;
+/**
+ * Log a debug message.
+ *
+ * Reassigned by {@link configureLogger} rather than implemented as a wrapper, and that is the whole
+ * point: the browser attributes a console entry to the frame that **called** `console.*`, so routing
+ * every level through one internal `logMessage()` helper made DevTools blame this file — every line
+ * of the application linked to `logger.ts` instead of its caller. Exporting the *bound* console
+ * method makes the caller the invoking frame, so the source link is the code that logged.
+ *
+ * Two consequences to know about:
+ *  - These are live ESM bindings. `import { debug }` follows a later `configureLogger()`, but
+ *    capturing the value first (`const { debug } = await import(…)`) freezes the level it was
+ *    configured with.
+ *  - The `console` method is captured when the binding is built, so anything that replaces
+ *    `console.*` afterwards — a test spy, an error-reporting SDK, a log shipper — is bypassed.
+ *    Install such a wrapper before importing this module, or call `configureLogger({})` after
+ *    installing it to rebuild the bindings against it.
+ */
+export declare let debug: LogFn;
+/** Log an info message. @see debug for why this is a binding rather than a function. */
+export declare let info: LogFn;
+/** Log a warning message. @see debug for why this is a binding rather than a function. */
+export declare let warn: LogFn;
+/** Log an error message. @see debug for why this is a binding rather than a function. */
+export declare let error: LogFn;
 /**
  * Configure the logger system
  * @param config - Logger configuration options
  */
 export declare function configureLogger(config: Partial<LoggerConfig>): void;
-/**
- * Log a debug message
- */
-export declare function debug(message: string, data?: unknown): void;
-/**
- * Log an info message
- */
-export declare function info(message: string, data?: unknown): void;
-/**
- * Log a warning message
- */
-export declare function warn(message: string, data?: unknown): void;
-/**
- * Log an error message
- */
-export declare function error(message: string, error?: unknown): void;
 export {};
 //# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,IAAI,IAAI;CACT;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,mBAAmB,EAAE,OAAO,CAAC;CAE9B;AAQD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAEnE;AA+BD;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAE5D"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,IAAI,IAAI;CACT;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,mBAAmB,EAAE,OAAO,CAAC;CAE9B;AAQD,+CAA+C;AAC/C,KAAK,KAAK,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAIvD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,IAAI,KAAK,EAAE,KAAY,CAAC;AAE/B,wFAAwF;AACxF,eAAO,IAAI,IAAI,EAAE,KAAY,CAAC;AAE9B,0FAA0F;AAC1F,eAAO,IAAI,IAAI,EAAE,KAAY,CAAC;AAE9B,yFAAyF;AACzF,eAAO,IAAI,KAAK,EAAE,KAAY,CAAC;AA0B/B;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAGnE"}

package/dist/web-api/helpers/aad-http-client-manager.d.ts

@@ -41,6 +41,14 @@ declare class AadHttpClientManager {
     initialize(client: AadHttpClientLike | null): void;
     /** @throws if no client has been initialized. */
     getClient(): AadHttpClientLike;
+    /**
+     * The v1 request configuration every `AadHttpClient` call needs. The SPFx SDK exposes it as a
+     * static member of the client's class, which is not describable on the instance type — so the
+     * single cast needed lives here rather than being repeated at each call site.
+     *
+     * @throws if no client has been initialized.
+     */
+    getConfiguration(): unknown;
     isInitialized(): boolean;
 }
 export declare const aadHttpClientManager: AadHttpClientManager;

package/dist/web-api/helpers/aad-http-client-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aad-http-client-manager.d.ts","sourceRoot":"","sources":["../../../src/web-api/helpers/aad-http-client-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,IAAI,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACzC,KAAK,CAAC,IAAI,mBAAmB,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,CACD,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,OAAO,EACtB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,IAAI,CACF,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,OAAO,EACtB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CACH,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,OAAO,EACtB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,cAAM,oBAAoB;IACxB,OAAO,CAAC,MAAM,CAAkC;IAEhD,0DAA0D;IAC1D,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI;IAIlD,iDAAiD;IACjD,SAAS,IAAI,iBAAiB;IAS9B,aAAa,IAAI,OAAO;CAGzB;AAGD,eAAO,MAAM,oBAAoB,sBAA6B,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAC/B,IAAI,CAEN"}
+{"version":3,"file":"aad-http-client-manager.d.ts","sourceRoot":"","sources":["../../../src/web-api/helpers/aad-http-client-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,IAAI,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACzC,KAAK,CAAC,IAAI,mBAAmB,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,CACD,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,OAAO,EACtB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,IAAI,CACF,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,OAAO,EACtB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CACH,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,OAAO,EACtB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,cAAM,oBAAoB;IACxB,OAAO,CAAC,MAAM,CAAkC;IAEhD,0DAA0D;IAC1D,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI;IAIlD,iDAAiD;IACjD,SAAS,IAAI,iBAAiB;IAS9B;;;;;;OAMG;IACH,gBAAgB,IAAI,OAAO;IAO3B,aAAa,IAAI,OAAO;CAGzB;AAGD,eAAO,MAAM,oBAAoB,sBAA6B,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAC/B,IAAI,CAEN"}

package/dist/web-api/helpers/create-headers.d.ts

@@ -1,6 +1,15 @@
+import { type AtomicContext } from "../../client/atomic-context";
+/**
+ * Builds the headers of a request for a context: CSRF token, bearer token and impersonation.
+ */
+export declare function createHeadersWithContext(ctx: AtomicContext, headers?: Headers): Headers;
 /**
  * Creates headers for a web API request.
  * @returns {Headers} The headers object.
+ *
+ * @deprecated Implementation detail of the HTTP helpers, which already call it on every request.
+ * Pass your own `headers` in the request options instead. It will stop being exported in the next
+ * major.
  */
 export declare function createHeaders(headers?: Headers): Headers;
 //# sourceMappingURL=create-headers.d.ts.map

package/dist/web-api/helpers/create-headers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-headers.d.ts","sourceRoot":"","sources":["../../../src/web-api/helpers/create-headers.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAuBxD"}
+{"version":3,"file":"create-headers.d.ts","sourceRoot":"","sources":["../../../src/web-api/helpers/create-headers.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,6BAA6B,CAAC;AAGrC;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAyBT;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAExD"}

package/dist/web-api/helpers/errors/api-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-error.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/errors/api-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,MAAM,EAAE,MAAM,CAAC;gBAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK5C"}
+{"version":3,"file":"api-error.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/errors/api-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,MAAM,EAAE,MAAM,CAAC;gBAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAO5C"}

package/dist/web-api/helpers/handle-response.d.ts

@@ -1,3 +1,4 @@
+import { type AtomicContext } from "../../client/atomic-context";
 import type { AadHttpResponseLike } from "./aad-http-client-manager";
 type ResponseLike = Response | AadHttpResponseLike;
 /**
@@ -6,7 +7,22 @@ type ResponseLike = Response | AadHttpResponseLike;
  * @param response - The response from the web API (standard Response or SPFx HttpClientResponse).
  * @param responseType - The type of response expected ('arraybuffer', 'blob', 'json', or 'text')
  * @returns A promise that resolves to the response data of type T.
+ *
+ * @deprecated Implementation detail of the HTTP helpers, which already apply it to every response.
+ * Use `get`/`post`/`put`/`patch`/`del`, or subscribe to `onAuthEvent("unauthorized", …)` to react to
+ * a 401. It will stop being exported in the next major.
+ */
+export declare function handleResponse<T>(response: ResponseLike, responseType?: "arraybuffer" | "blob" | "json" | "text" | "response"): Promise<T>;
+/**
+ * Handles the response of a request made on a context: sliding token refresh, body parsing, and
+ * typed errors (with the `unauthorized` event raised on the context's own subscribers).
+ */
+export declare function handleResponseWithContext<T>(ctx: AtomicContext, response: ResponseLike, responseType?: "arraybuffer" | "blob" | "json" | "text" | "response", 
+/**
+ * URL the request was sent to. Passed explicitly because `response.url` is empty on a synthetic
+ * Response (an injected `fetch`, an SPFx transport), which would leave the error events without
+ * an endpoint.
  */
-export declare function handleResponse<T>(response: ResponseLike, responseType?: "arraybuffer" | "blob" | "json" | "text"): Promise<T>;
+endpoint?: string): Promise<T>;
 export {};
 //# sourceMappingURL=handle-response.d.ts.map

package/dist/web-api/helpers/handle-response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handle-response.d.ts","sourceRoot":"","sources":["../../../src/web-api/helpers/handle-response.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAMrE,KAAK,YAAY,GAAG,QAAQ,GAAG,mBAAmB,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,QAAQ,EAAE,YAAY,EACtB,YAAY,GAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAe,GAC9D,OAAO,CAAC,CAAC,CAAC,CA2DZ"}
+{"version":3,"file":"handle-response.d.ts","sourceRoot":"","sources":["../../../src/web-api/helpers/handle-response.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAMrE,KAAK,YAAY,GAAG,QAAQ,GAAG,mBAAmB,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,QAAQ,EAAE,YAAY,EACtB,YAAY,GAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAmB,GAC3E,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,YAAY,EACtB,YAAY,GAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAmB;AAC5E;;;;GAIG;AACH,QAAQ,SAAqB,GAC5B,OAAO,CAAC,CAAC,CAAC,CAkEZ"}

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

@@ -11,7 +11,7 @@ export * from "./methods/post";
 export * from "./methods/put";
 export * from "./request-options";
 export * from "./utils/create-timeout-controller";
-export * from "./utils/date-utils.";
+export * from "./utils/date-utils";
 export * from "./utils/resolve-no-auto-authentication";
 export * from "./utils/with-retry";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/web-api/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,qBAAqB,CAAC;AACpC,cAAc,wCAAwC,CAAC;AACvD,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/web-api/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,oBAAoB,CAAC;AACnC,cAAc,wCAAwC,CAAC;AACvD,cAAc,oBAAoB,CAAC"}

package/dist/web-api/helpers/methods/del.d.ts

@@ -1,20 +1,22 @@
+import { type AtomicContext } from "../../../client/atomic-context";
 import type { API_ENDPOINTS } from "../../../types";
+import type { RequestOptions } from "../request-options";
+/** Options of a DELETE request: the shared ones, plus an optional JSON payload. */
+export type DeleteOptions = RequestOptions & {
+    body?: Record<string, unknown>;
+};
+/** Makes a DELETE request on the given context. */
+export declare function delWithContext<T>(ctx: AtomicContext, endpoint: API_ENDPOINTS, params?: URLSearchParams, options?: DeleteOptions): Promise<T>;
 /**
  * Makes a DELETE request to the specified API endpoint.
  *
  * @param endpoint - The API endpoint to send the request to.
  * @param params - The URL parameters to include in the request.
- * @param options - Additional options for the request.
- * @param options.headers - Custom headers to include in the request.
- * @param options.responseType - The expected type of response data.
- * @param options.body - Optional JSON body (e.g. bulk-delete endpoints that need a payload
- *   alongside the DELETE method). `app`/`locale`/`noUserOverride`/`noAutoAuthentication` are
- *   merged in automatically, same as `post`/`put`.
+ * @param options - Additional options for the request (see {@link RequestOptions}), plus an
+ *   optional JSON `body` (e.g. bulk-delete endpoints that need a payload alongside the DELETE
+ *   method). `app`/`locale`/`noUserOverride`/`noAutoAuthentication` are merged into that body
+ *   automatically, same as `post`/`put`.
  * @returns A promise that resolves to the response data of type T.
  */
-export declare function del<T>(endpoint: API_ENDPOINTS, params?: URLSearchParams, options?: {
-    headers?: Headers;
-    responseType?: "arraybuffer" | "blob" | "json" | "text";
-    body?: Record<string, unknown>;
-}): Promise<T>;
+export declare function del<T>(endpoint: API_ENDPOINTS, params?: URLSearchParams, options?: DeleteOptions): Promise<T>;
 //# sourceMappingURL=del.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"del.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/methods/del.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAOpD;;;;;;;;;;;;GAYG;AACH,wBAAsB,GAAG,CAAC,CAAC,EACzB,QAAQ,EAAE,aAAa,EACvB,MAAM,CAAC,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GACA,OAAO,CAAC,CAAC,CAAC,CAsDZ"}
+{"version":3,"file":"del.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/methods/del.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAEhF,mDAAmD;AACnD,wBAAsB,cAAc,CAAC,CAAC,EACpC,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,aAAa,EACvB,MAAM,CAAC,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,CAAC,CAAC,CAyBZ;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,GAAG,CAAC,CAAC,EACzB,QAAQ,EAAE,aAAa,EACvB,MAAM,CAAC,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,CAAC,CAAC,CAEZ"}

package/dist/web-api/helpers/methods/get.d.ts

@@ -1,21 +1,15 @@
+import { type AtomicContext } from "../../../client/atomic-context";
 import type { API_ENDPOINTS } from "../../../types";
+import type { RequestOptions } from "../request-options";
+/** Makes a GET request on the given context. */
+export declare function getWithContext<T>(ctx: AtomicContext, endpoint: API_ENDPOINTS, params?: URLSearchParams, options?: RequestOptions): Promise<T>;
 /**
  * Makes a GET request to the specified API endpoint with the given parameters.
  *
  * @param endpoint - The API endpoint to send the GET request to.
  * @param params - The URL parameters to include in the request.
- * @param options - Additional options for the request.
- * @param options.headers - Custom headers to include in the request.
- * @param options.responseType - The expected type of response data.
- * @param options.redirect - 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.
+ * @param options - Additional options for the request (see {@link RequestOptions}).
  * @returns A Promise that resolves to the response data of type T.
  */
-export declare function get<T>(endpoint: API_ENDPOINTS, params?: URLSearchParams, options?: {
-    headers?: Headers;
-    responseType?: "arraybuffer" | "blob" | "json" | "text";
-    signal?: AbortSignal;
-    redirect?: RequestRedirect;
-}): Promise<T>;
+export declare function get<T>(endpoint: API_ENDPOINTS, params?: URLSearchParams, options?: RequestOptions): Promise<T>;
 //# sourceMappingURL=get.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/methods/get.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMpD;;;;;;;;;;;;GAYG;AACH,wBAAsB,GAAG,CAAC,CAAC,EACzB,QAAQ,EAAE,aAAa,EACvB,MAAM,CAAC,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACxD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,GACA,OAAO,CAAC,CAAC,CAAC,CA6CZ"}
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/methods/get.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD,gDAAgD;AAChD,wBAAsB,cAAc,CAAC,CAAC,EACpC,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,aAAa,EACvB,MAAM,CAAC,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAuBZ;AAED;;;;;;;GAOG;AACH,wBAAsB,GAAG,CAAC,CAAC,EACzB,QAAQ,EAAE,aAAa,EACvB,MAAM,CAAC,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAEZ"}

package/dist/web-api/helpers/methods/patch.d.ts

@@ -1,16 +1,15 @@
+import { type AtomicContext } from "../../../client/atomic-context";
 import type { API_ENDPOINTS } from "../../../types";
+import type { RequestOptions } from "../request-options";
+/** Makes a PATCH request on the given context. */
+export declare function patchWithContext<T>(ctx: AtomicContext, endpoint: API_ENDPOINTS, body: Record<string, unknown>, options?: RequestOptions): Promise<T>;
 /**
  * Makes a PATCH request to the specified API endpoint.
  *
  * @param endpoint - The API endpoint to send the request to.
  * @param body - The request body as a record of key-value pairs.
- * @param options - Additional options for the request.
- * @param options.headers - Custom headers to include in the request.
- * @param options.responseType - The expected type of response data.
+ * @param options - Additional options for the request (see {@link RequestOptions}).
  * @returns A promise that resolves to the response data of type T.
  */
-export declare function patch<T>(endpoint: API_ENDPOINTS, body: Record<string, unknown>, options?: {
-    headers?: Headers;
-    responseType?: "arraybuffer" | "blob" | "json" | "text";
-}): Promise<T>;
+export declare function patch<T>(endpoint: API_ENDPOINTS, body: Record<string, unknown>, options?: RequestOptions): Promise<T>;
 //# sourceMappingURL=patch.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/methods/patch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAOpD;;;;;;;;;GASG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CACzD,GACA,OAAO,CAAC,CAAC,CAAC,CA2CZ"}
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/methods/patch.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD,kDAAkD;AAClD,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAkBZ;AAED;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAEZ"}

package/dist/web-api/helpers/methods/post.d.ts

@@ -1,18 +1,16 @@
+import { type AtomicContext } from "../../../client/atomic-context";
 import type { API_ENDPOINTS } from "../../../types";
+import type { RequestOptions } from "../request-options";
+/** Makes a POST request on the given context. */
+export declare function postWithContext<T>(ctx: AtomicContext, endpoint: API_ENDPOINTS, body: Record<string, unknown>, options?: RequestOptions): Promise<T>;
 /**
  * Makes a POST request to the specified API endpoint.
  * `app` and `locale` are added automatically to the request body.
  *
  * @param endpoint - The API endpoint to send the request to.
  * @param body - The request body as a record of key-value pairs.
- * @param options - Additional options for the request.
- * @param options.headers - Custom headers to include in the request.
- * @param options.responseType - The expected type of response data.
+ * @param options - Additional options for the request (see {@link RequestOptions}).
  * @returns A promise that resolves to the response data of type T.
  */
-export declare function post<T>(endpoint: API_ENDPOINTS, body: Record<string, unknown>, options?: {
-    headers?: Headers;
-    responseType?: "arraybuffer" | "blob" | "json" | "text";
-    signal?: AbortSignal;
-}): Promise<T>;
+export declare function post<T>(endpoint: API_ENDPOINTS, body: Record<string, unknown>, options?: RequestOptions): Promise<T>;
 //# sourceMappingURL=post.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/methods/post.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAOpD;;;;;;;;;;GAUG;AACH,wBAAsB,IAAI,CAAC,CAAC,EAC1B,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACxD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GACA,OAAO,CAAC,CAAC,CAAC,CAqDZ"}
+{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/methods/post.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD,iDAAiD;AACjD,wBAAsB,eAAe,CAAC,CAAC,EACrC,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED;;;;;;;;GAQG;AACH,wBAAsB,IAAI,CAAC,CAAC,EAC1B,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAEZ"}

package/dist/web-api/helpers/methods/put.d.ts

@@ -1,16 +1,15 @@
+import { type AtomicContext } from "../../../client/atomic-context";
 import type { API_ENDPOINTS } from "../../../types";
+import type { RequestOptions } from "../request-options";
+/** Makes a PUT request on the given context. */
+export declare function putWithContext<T>(ctx: AtomicContext, endpoint: API_ENDPOINTS, body: Record<string, unknown>, options?: RequestOptions): Promise<T>;
 /**
  * Makes a PUT request to the specified API endpoint.
  *
  * @param endpoint - The API endpoint to send the request to.
  * @param body - The request body as a record of key-value pairs.
- * @param options - Additional options for the request.
- * @param options.headers - Custom headers to include in the request.
- * @param options.responseType - The expected type of response data.
+ * @param options - Additional options for the request (see {@link RequestOptions}).
  * @returns A promise that resolves to the response data of type T.
  */
-export declare function put<T>(endpoint: API_ENDPOINTS, body: Record<string, unknown>, options?: {
-    headers?: Headers;
-    responseType?: "arraybuffer" | "blob" | "json" | "text";
-}): Promise<T>;
+export declare function put<T>(endpoint: API_ENDPOINTS, body: Record<string, unknown>, options?: RequestOptions): Promise<T>;
 //# sourceMappingURL=put.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"put.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/methods/put.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAOpD;;;;;;;;;GASG;AACH,wBAAsB,GAAG,CAAC,CAAC,EACzB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CACzD,GACA,OAAO,CAAC,CAAC,CAAC,CA8CZ"}
+{"version":3,"file":"put.d.ts","sourceRoot":"","sources":["../../../../src/web-api/helpers/methods/put.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD,gDAAgD;AAChD,wBAAsB,cAAc,CAAC,CAAC,EACpC,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED;;;;;;;GAOG;AACH,wBAAsB,GAAG,CAAC,CAAC,EACzB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAEZ"}

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