@asgardeo/javascript 0.10.2 → 0.12.0

package/dist/models/config.d.ts

@@ -111,6 +111,84 @@ export interface BaseConfig<T = unknown> extends WithPreferences {
      * Not recommended for public clients like browser applications.
      */
     clientSecret?: string | undefined;
+    /**
+     * OpenID Connect discovery configuration.
+     * Controls how the SDK resolves endpoint URLs from the authorization server.
+     * Each discovery mechanism is independently configurable.
+     *
+     * @example
+     * // Use a custom well-known discovery document URL
+     * discovery: { wellKnown: { endpoint: "https://custom.example.com/.well-known/openid-configuration" } }
+     *
+     * @example
+     * // Disable well-known discovery entirely
+     * discovery: { wellKnown: { enabled: false } }
+     */
+    discovery?: {
+        /**
+         * Configuration for OpenID Connect Discovery via the well-known endpoint (RFC 8414).
+         * The SDK fetches `{baseUrl}/oauth2/token/.well-known/openid-configuration` by default.
+         */
+        wellKnown?: {
+            /**
+             * Whether to fetch and use the well-known discovery document to resolve endpoint URLs.
+             * @default true
+             */
+            enabled?: boolean;
+        };
+    };
+    /**
+     * Optional overrides for the OIDC protocol endpoints.
+     * By default, the SDK derives all endpoint URLs from the well-known discovery document
+     * located at `{baseUrl}/oauth2/token/.well-known/openid-configuration`.
+     * Use this when your authorization server exposes endpoints at non-standard paths,
+     * or when a custom domain differs from `baseUrl`.
+     *
+     * Individual overrides take precedence over values resolved from the discovery document.
+     *
+     * @example
+     * endpoints: {
+     *   wellKnown: "https://custom-domain.example.com/.well-known/openid-configuration",
+     *   authorization: "https://custom-domain.example.com/oauth2/authorize",
+     * }
+     */
+    endpoints?: {
+        /**
+         * The authorization endpoint URL.
+         * If not provided, resolved from the well-known discovery document.
+         */
+        authorization?: string;
+        /**
+         * The end-session (logout) endpoint URL.
+         * If not provided, resolved from the well-known discovery document.
+         */
+        endSession?: string;
+        /**
+         * The introspection endpoint URL.
+         * If not provided, resolved from the well-known discovery document.
+         */
+        introspection?: string;
+        /**
+         * The JSON Web Key Set (JWKS) endpoint URL used to fetch public keys for token verification.
+         * If not provided, resolved from the well-known discovery document.
+         */
+        jwks?: string;
+        /**
+         * The token endpoint URL.
+         * If not provided, resolved from the well-known discovery document.
+         */
+        token?: string;
+        /**
+         * The userinfo endpoint URL.
+         * If not provided, resolved from the well-known discovery document.
+         */
+        userInfo?: string;
+        /**
+         * The OpenID Connect discovery document URL.
+         * Defaults to `{baseUrl}/oauth2/token/.well-known/openid-configuration`.
+         */
+        wellKnown?: string;
+    };
     /**
      * Optional instance ID for multi-auth context support.
      * Use this when you need multiple authentication contexts in the same application.
@@ -314,6 +392,27 @@ export interface I18nPreferences {
      */
     urlParam?: string | false;
 }
+export interface UserPreferences {
+    /**
+     * Whether to automatically fetch the user's associated organizations after sign-in.
+     * When set to false, the SDK will not make API calls to `/api/users/v1/me/organizations`.
+     * @default true
+     * @remarks Disabling this will improve performance if you don't need organization information.
+     * You can manually call `getMyOrganizations()` when needed if this is disabled.
+     */
+    fetchOrganizations?: boolean;
+    /**
+     * Whether to automatically fetch the user profile from SCIM2 endpoints after sign-in.
+     * When set to false, the SDK will not make API calls to `/scim2/Me` and `/scim2/Schemas`.
+     * Instead, it will extract basic user claims from the ID token.
+     * @default true
+     * @remarks Disabling this will improve performance but provide limited user profile information.
+     * Only the claims present in the ID token will be available (e.g., sub, email, name).
+     * For full user profile attributes (custom claims, enterprise attributes, etc.),
+     * keep this enabled or manually call `getUserProfile()` when needed.
+     */
+    fetchUserProfile?: boolean;
+}
 export interface Preferences {
     /**
      * Internationalization preferences for the Asgardeo UI components
@@ -328,4 +427,10 @@ export interface Preferences {
      * Theme preferences for the Asgardeo UI components
      */
     theme?: ThemePreferences;
+    /**
+     * User profile preferences for controlling user data fetching behavior.
+     * TEMPORARY CONFIG
+     * TODO: Remove this once https://github.com/asgardeo/javascript/issues/412 is properly fixed.
+     */
+    user?: UserPreferences;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asgardeo/javascript",
-  "version": "0.10.2",
+  "version": "0.12.0",
   "description": "Framework agnostic JavaScript SDK for Asgardeo.",
   "keywords": [
     "asgardeo",