feat: support relative baseUrls (#950)

Signed-off-by: Todd Baert <todd.baert@dynatrace.com>

libs/providers/ofrep-web/src/lib/ofrep-web-provider.ts

@@ -64,13 +64,6 @@ export class OFREPWebProvider implements Provider {
   private _pollingIntervalId?: number;
 
   constructor(options: OFREPWebProviderOptions, logger?: Logger) {
-    try {
-      // Cannot use URL.canParse as it is only available from Node 19.x
-      new URL(options.baseUrl);
-    } catch {
-      throw new Error(`The given OFREP URL "${options.baseUrl}" is not a valid URL.`);
-    }
-
     this._options = options;
     this._logger = logger;
     this._etag = null;

libs/shared/ofrep-core/src/lib/provider/ofrep-provider-options.ts

@@ -5,9 +5,26 @@ export type HttpHeaderMap = Record<string, string>;
 export type HttpHeaders = HttpHeaderList | HttpHeaderMap;
 
 export type OFREPProviderBaseOptions = {
+  /**
+   * Base URL for OFREP requests. Relative paths are supported.
+   * For example, if your OFREP instance is available at
+   * "https://host.com/path/{ofrep-api}" , you should set this to
+   * "https://host.com/path" or "/path" (if your app and OFREP instance
+   * share the same origin).
+   */
   baseUrl: string;
+  /**
+   * Optional fetch implementation
+   */
   fetchImplementation?: FetchAPI;
+  /**
+   * Optional Headers supplier function.
+   * @returns HttpHeaders
+   */
   headersFactory?: () => HttpHeaders;
+  /**
+   * Optional static headers.
+   */
   headers?: HttpHeaders;
 };