Mark API as experimental

.changeset/young-wolves-clap.md

@@ -2,8 +2,10 @@
 "@open-pioneer/http": minor
 ---
 
-New feature: request interceptors.
+New **experimental** feature: request interceptors.
 Request interceptors can be registered with the `HttpService` to modify requests before they are sent to a server.
 Request interceptors are called automatically by the `HttpService` when they are present as part of the normal request processing.
 
 Example use case: adding an access token (query parameter or header) to requests for a certain resource.
+
+Note that the request interceptor API is experimental: it may change with a new minor release as a response to feedback.

src/packages/http/README.md

@@ -45,6 +45,8 @@ However, the `HttpService`'s method should always be preferred to take advantage
 
 ## Request interceptors
 
+> Note that the request interceptor API is experimental: it may change with a new minor release as a response to feedback.
+
 The `HttpService` supports extension via _request interceptors_.
 Request interceptors can modify requests (query parameters, headers, etc.) before they are sent to the server.
 

src/packages/http/api.ts

@@ -78,6 +78,8 @@ export type ContextData = Record<string | symbol, unknown>;
  * or to manipulate a backend response.
  *
  * Use the interface name `http.Interceptor` to provide an implementation of this interface.
+ *
+ * > Note that the request interceptor API is experimental: it may change with a new minor release as a response to feedback.
  */
 export interface Interceptor extends DeclaredService<"http.Interceptor"> {
     beforeRequest?(params: BeforeRequestParams): void | Promise<void>;