@asgardeo/javascript 0.15.0 → 0.16.0

package/dist/HttpClient.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { HttpError, HttpRequestConfig, HttpResponse } from './models/http';
+/**
+ * Abstract base class for HTTP clients. Owns all handler/callback state and
+ * the request lifecycle (pre-processing, transport, post-processing).
+ *
+ * Extend this class and implement `transport()` to plug in a custom HTTP transport.
+ *
+ * @example
+ * ```ts
+ * class MyHttpClient extends HttpClient {
+ *   protected async transport<T>(config: HttpRequestConfig): Promise<HttpResponse<T>> {
+ *     // custom fetch logic
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class HttpClient {
+    private isHandlerEnabled;
+    private attachToken;
+    private static readonly DEFAULT_HANDLER_DISABLE_TIMEOUT;
+    private requestStartCallback;
+    private requestSuccessCallback;
+    private requestErrorCallback;
+    private requestFinishCallback;
+    constructor(isHandlerEnabled?: boolean, attachToken?: (request: HttpRequestConfig) => Promise<void>);
+    /**
+     * Implemented by subclasses. Performs the actual HTTP call with no handler
+     * logic applied — that is handled by `request()`.
+     */
+    protected abstract transport<T = any>(config: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /**
+     * Public HTTP request entry point. Applies pre/post processing around `transport()`.
+     */
+    request<T = any>(config: HttpRequestConfig): Promise<HttpResponse<T>>;
+    enableHandler(): void;
+    disableHandler(): void;
+    disableHandlerWithTimeout(timeout?: number): void;
+    setHttpRequestStartCallback(cb: (req: HttpRequestConfig) => void): void;
+    setHttpRequestSuccessCallback(cb: (res: HttpResponse) => void): void;
+    setHttpRequestErrorCallback(cb: (err: HttpError) => void): void;
+    setHttpRequestFinishCallback(cb: () => void): void;
+    all<T>(values: (T | Promise<T>)[]): Promise<T[]>;
+    spread<T, R>(callback: (...args: T[]) => R): (array: T[]) => R;
+    protected requestHandler(config: HttpRequestConfig): Promise<HttpRequestConfig>;
+    protected successHandler(response: HttpResponse): HttpResponse;
+    protected errorHandler(error: HttpError): void;
+}

package/dist/cjs/index.js

@@ -62,6 +62,7 @@ __export(index_exports, {
   FieldType: () => FieldType,
   FlowMetaType: () => FlowMetaType,
   FlowMode: () => FlowMode,
+  HttpClient: () => HttpClient,
   IsomorphicCrypto: () => IsomorphicCrypto,
   OIDCRequestConstants: () => OIDCRequestConstants_default,
   Platform: () => Platform,
@@ -5418,6 +5419,103 @@ var transformBrandingPreferenceToTheme = (brandingPreference, forceTheme) => {
   return createTheme_default(transformedConfig, activeThemeKey === "DARK");
 };
 var transformBrandingPreferenceToTheme_default = transformBrandingPreferenceToTheme;
+
+// src/HttpClient.ts
+var _HttpClient = class _HttpClient {
+  constructor(isHandlerEnabled = true, attachToken = () => Promise.resolve()) {
+    this.isHandlerEnabled = isHandlerEnabled;
+    this.attachToken = attachToken;
+    // eslint-disable-next-line class-methods-use-this
+    __publicField(this, "requestStartCallback", () => null);
+    // eslint-disable-next-line class-methods-use-this
+    __publicField(this, "requestSuccessCallback", () => null);
+    // eslint-disable-next-line class-methods-use-this
+    __publicField(this, "requestErrorCallback", () => null);
+    // eslint-disable-next-line class-methods-use-this
+    __publicField(this, "requestFinishCallback", () => null);
+  }
+  /**
+   * Public HTTP request entry point. Applies pre/post processing around `transport()`.
+   */
+  async request(config) {
+    const processedConfig = await this.requestHandler(config);
+    try {
+      const response = await this.transport(processedConfig);
+      return this.successHandler(response);
+    } catch (error2) {
+      this.errorHandler(error2);
+      throw error2;
+    }
+  }
+  enableHandler() {
+    this.isHandlerEnabled = true;
+  }
+  disableHandler() {
+    this.isHandlerEnabled = false;
+  }
+  disableHandlerWithTimeout(timeout = _HttpClient.DEFAULT_HANDLER_DISABLE_TIMEOUT) {
+    this.isHandlerEnabled = false;
+    setTimeout(() => {
+      this.isHandlerEnabled = true;
+    }, timeout);
+  }
+  setHttpRequestStartCallback(cb) {
+    this.requestStartCallback = cb;
+  }
+  setHttpRequestSuccessCallback(cb) {
+    this.requestSuccessCallback = cb;
+  }
+  setHttpRequestErrorCallback(cb) {
+    this.requestErrorCallback = cb;
+  }
+  setHttpRequestFinishCallback(cb) {
+    this.requestFinishCallback = cb;
+  }
+  // eslint-disable-next-line class-methods-use-this
+  all(values) {
+    return Promise.all(values);
+  }
+  // eslint-disable-next-line class-methods-use-this
+  spread(callback) {
+    return (array) => callback(...array);
+  }
+  async requestHandler(config) {
+    await this.attachToken(config);
+    if (config.shouldEncodeToFormData && config.data) {
+      const formData = new FormData();
+      Object.keys(config.data).forEach((key) => formData.append(key, config.data[key]));
+      config.data = formData;
+    }
+    config.startTimeInMs = Date.now();
+    if (this.isHandlerEnabled && typeof this.requestStartCallback === "function") {
+      this.requestStartCallback(config);
+    }
+    return config;
+  }
+  successHandler(response) {
+    if (this.isHandlerEnabled) {
+      if (typeof this.requestSuccessCallback === "function") {
+        this.requestSuccessCallback(response);
+      }
+      if (typeof this.requestFinishCallback === "function") {
+        this.requestFinishCallback();
+      }
+    }
+    return response;
+  }
+  errorHandler(error2) {
+    if (this.isHandlerEnabled) {
+      if (typeof this.requestErrorCallback === "function") {
+        this.requestErrorCallback(error2);
+      }
+      if (typeof this.requestFinishCallback === "function") {
+        this.requestFinishCallback();
+      }
+    }
+  }
+};
+__publicField(_HttpClient, "DEFAULT_HANDLER_DISABLE_TIMEOUT", 1e3);
+var HttpClient = _HttpClient;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentConfig,
@@ -5451,6 +5549,7 @@ var transformBrandingPreferenceToTheme_default = transformBrandingPreferenceToTh
   FieldType,
   FlowMetaType,
   FlowMode,
+  HttpClient,
   IsomorphicCrypto,
   OIDCRequestConstants,
   Platform,