@asgardeo/javascript 0.7.3 → 0.8.1

package/dist/models/agent.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Copyright (c) 2026, 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.
+ */
+/**
+ * Interface representing the configuration for an agent.
+ */
+export interface AgentConfig {
+    /**
+     * The unique identifier for the agent
+     */
+    agentID: string;
+    /**
+     * The secret credential for the agent
+     */
+    agentSecret: string;
+    /**
+     * The authenticator name to match during the embedded sign-in flow.
+     * Defaults to {@link AgentConfig.DEFAULT_AUTHENTICATOR_NAME} if not provided.
+     */
+    authenticatorName?: string;
+}
+/**
+ * Namespace that holds constants related to {@link AgentConfig}.
+ */
+export declare namespace AgentConfig {
+    /**
+     * Default authenticator name used when none is specified.
+     */
+    const DEFAULT_AUTHENTICATOR_NAME: string;
+}

package/dist/models/auth-code-response.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) 2026, 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.
+ */
+/**
+ * Interface representing the authorization code response from the OAuth2/OIDC flow.
+ */
+export interface AuthCodeResponse {
+    /**
+     * The authorization code returned from the authorization endpoint
+     */
+    code: string;
+    /**
+     * The session state identifier
+     */
+    session_state: string;
+    /**
+     * The state parameter returned from the authorization endpoint
+     */
+    state: string;
+}

package/dist/models/config.d.ts

@@ -262,6 +262,11 @@ export interface Preferences {
      * Internationalization preferences for the Asgardeo UI components
      */
     i18n?: I18nPreferences;
+    /**
+     * Whether to resolve the theme from the Flow Meta API (GET /flow/meta).
+     * @remarks This is only applicable when using platform `Asgardeo V2` (Thunder).
+     */
+    resolveFromMeta?: boolean;
     /**
      * Theme preferences for the Asgardeo UI components
      */

package/dist/models/crypto.d.ts

@@ -80,7 +80,7 @@ export interface Crypto<T = any> {
      *
      * @returns Hashed data.
      */
-    hashSha256(data: string): T;
+    hashSha256(data: string): T | Promise<T>;
     /**
      * Verify the provided JWT.
      *

package/dist/models/v2/embedded-flow-v2.d.ts

@@ -44,14 +44,22 @@ export declare enum EmbeddedFlowComponentType {
     Divider = "DIVIDER",
     /** Email input field with validation for email addresses. */
     EmailInput = "EMAIL_INPUT",
+    /** Icon display component for rendering named vector icons */
+    Icon = "ICON",
+    /** Image display component for logos and illustrations */
+    Image = "IMAGE",
     /** One-time password input field for multi-factor authentication */
     OtpInput = "OTP_INPUT",
     /** Password input field with masking for sensitive data */
     PasswordInput = "PASSWORD_INPUT",
     /** Phone number input field with country code support */
     PhoneInput = "PHONE_INPUT",
+    /** Rich text display component that renders formatted HTML content */
+    RichText = "RICH_TEXT",
     /** Select/dropdown input component for single choice selection */
     Select = "SELECT",
+    /** Stack layout component for arranging children in a row or column */
+    Stack = "STACK",
     /** Text display component for labels, headings, and messages */
     Text = "TEXT",
     /** Standard text input field for user data entry */
@@ -159,23 +167,64 @@ export declare enum EmbeddedFlowEventType {
  */
 export interface EmbeddedFlowComponent {
     /**
-     * Nested child components for container components like Block.
+     * Alignment of children along the cross axis (for Stack components).
+     */
+    align?: string;
+    /**
+     * Alternative text for Image components.
+     */
+    alt?: string;
+    /**
+     * Icon color, CSS color value (for Icon components).
+     */
+    color?: string;
+    /**
+     * Nested child components for container components like Block and Stack.
      */
     components?: EmbeddedFlowComponent[];
+    /**
+     * Layout direction for Stack components ('row' | 'column').
+     */
+    direction?: string;
+    /**
+     * Icon to render at the end of an Action button (URL string).
+     */
+    endIcon?: string;
     /**
      * Event type for action components that defines the interaction behavior.
      * Only relevant for Action components.
      */
     eventType?: EmbeddedFlowEventType | string;
+    /**
+     * Gap between children in Stack components (number, maps to spacing units).
+     */
+    gap?: number;
+    /**
+     * Height of the component (for Image components, can be string with units or number for pixels).
+     * The value depends on the component type (e.g., for Image components).
+     */
+    height?: string | number;
     /**
      * Unique identifier for the component
      */
     id: string;
+    /**
+     * Number of items across the main axis (for Stack grid-like layouts).
+     */
+    items?: string | number;
+    /**
+     * Justification of children along the main axis (for Stack components).
+     */
+    justify?: string;
     /**
      * Display label for the component (e.g., field label, button text).
      * Supports internationalization and may contain template strings.
      */
     label?: string;
+    /**
+     * Icon name for Icon components (e.g., lucide-react icon names like 'ArrowLeftRight').
+     */
+    name?: string;
     /**
      * Options for SELECT components.
      * Each option can be a string value or an object with value and label.
@@ -198,6 +247,18 @@ export interface EmbeddedFlowComponent {
      * Used for form validation and UI indicators.
      */
     required?: boolean;
+    /**
+     * Icon size in pixels (for Icon components).
+     */
+    size?: number;
+    /**
+     * Image source URL (for Image components).
+     */
+    src?: string;
+    /**
+     * Icon to render at the start of an Action button (URL string).
+     */
+    startIcon?: string;
     /**
      * Component type that determines rendering behavior
      */
@@ -207,6 +268,11 @@ export interface EmbeddedFlowComponent {
      * The value depends on the component type (e.g., button variants, text variants).
      */
     variant?: EmbeddedFlowActionVariant | EmbeddedFlowTextVariant | string;
+    /**
+     * Width of the component (for Image components, can be string with units or number for pixels).
+     * The value depends on the component type (e.g., for Image components).
+     */
+    width?: string | number;
 }
 /**
  * Response data structure for embedded flow API.

package/dist/models/v2/flow-meta-v2.d.ts

@@ -0,0 +1,290 @@
+/**
+ * Copyright (c) 2026, 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.
+ */
+/**
+ * The type of entity to retrieve flow metadata for.
+ *
+ * @example
+ * ```typescript
+ * const config: GetFlowMetaRequestConfig = {
+ *   baseUrl: 'https://localhost:8090',
+ *   type: FlowMetaType.App,
+ *   id: '60a9b38b-6eba-9f9e-55f9-267067de4680',
+ * };
+ * ```
+ *
+ * @experimental This API may change in future versions
+ */
+export declare enum FlowMetaType {
+    /** Retrieve metadata scoped to a specific application */
+    App = "APP",
+    /** Retrieve metadata scoped to a specific organization unit */
+    Ou = "OU"
+}
+/**
+ * Application metadata returned when `type=APP`.
+ *
+ * @experimental This API may change in future versions
+ */
+export interface ApplicationMetadata {
+    /** Application UUID */
+    id: string;
+    /** URL of the application logo */
+    logo_url?: string;
+    /** Human-readable application name */
+    name: string;
+    /** Privacy Policy URI */
+    policy_uri?: string;
+    /** Terms of Service URI */
+    tos_uri?: string;
+    /** Application home URL */
+    url?: string;
+}
+/**
+ * Organization unit metadata.
+ *
+ * Always present when `type=OU`. For `type=APP`, only included when the
+ * deployment has exactly one organization unit.
+ *
+ * @experimental This API may change in future versions
+ */
+export interface OUMetadata {
+    /** Cookie Policy URI */
+    cookie_policy_uri?: string;
+    /** Optional description of the organization unit */
+    description?: string;
+    /** Unique handle / slug for the organization unit */
+    handle: string;
+    /** Organization unit UUID */
+    id: string;
+    /** URL of the organization unit logo */
+    logo_url?: string;
+    /** Human-readable organization unit name */
+    name: string;
+    /** Privacy Policy URI */
+    policy_uri?: string;
+    /** Terms of Service URI */
+    tos_uri?: string;
+}
+/**
+ * A single color entry in the v2 theme color scheme.
+ *
+ * @experimental This API may change in future versions
+ */
+export interface FlowMetaThemeColorSet {
+    /** Text color that contrasts against this color */
+    contrastText?: string;
+    /** The darker variant of the color */
+    dark?: string;
+    /** The main/primary variant of the color */
+    main: string;
+}
+/**
+ * Background colors in a v2 theme color scheme.
+ *
+ * @experimental This API may change in future versions
+ */
+export interface FlowMetaThemeBackground {
+    /** Default background color (maps to body background) */
+    default?: string;
+    /** Surface / paper background color */
+    paper?: string;
+}
+/**
+ * Text colors in a v2 theme color scheme.
+ *
+ * @experimental This API may change in future versions
+ */
+export interface FlowMetaThemeTextColors {
+    /** Primary text color */
+    primary?: string;
+    /** Secondary / muted text color */
+    secondary?: string;
+}
+/**
+ * All colors defined for a single v2 theme color scheme (light or dark).
+ *
+ * @experimental This API may change in future versions
+ */
+export interface FlowMetaThemeColors {
+    /** Background colors for the theme (e.g., body, paper) */
+    background?: FlowMetaThemeBackground;
+    /** Primary color set for the theme */
+    primary?: FlowMetaThemeColorSet;
+    /** Secondary color set for the theme */
+    secondary?: FlowMetaThemeColorSet;
+    /** Text colors for the theme */
+    text?: FlowMetaThemeTextColors;
+}
+/**
+ * A single color scheme (light or dark) in the v2 theme.
+ *
+ * @experimental This API may change in future versions
+ */
+export interface FlowMetaThemeColorScheme {
+    /** All colors defined for this color scheme (light or dark) */
+    palette: FlowMetaThemeColors;
+}
+/**
+ * Shape / geometry configuration in the v2 theme.
+ *
+ * @experimental This API may change in future versions
+ */
+export interface FlowMetaThemeShape {
+    /** Border radius in pixels applied uniformly across components */
+    borderRadius?: number;
+}
+/**
+ * Typography configuration in the v2 theme.
+ *
+ * @experimental This API may change in future versions
+ */
+export interface FlowMetaThemeTypography {
+    /** CSS font-family string */
+    fontFamily?: string;
+}
+/**
+ * Resolved theme configuration returned inside the flow metadata response.
+ *
+ * Maps to the `design.theme` field of {@link FlowMetadataResponse}.
+ *
+ * @experimental This API may change in future versions
+ */
+export interface FlowMetaTheme {
+    /** Per-scheme color definitions (light and dark) */
+    colorSchemes?: {
+        /** Dark color scheme */
+        dark?: FlowMetaThemeColorScheme;
+        /** Light color scheme */
+        light?: FlowMetaThemeColorScheme;
+    };
+    /** The color scheme to apply by default */
+    defaultColorScheme?: 'light' | 'dark';
+    /** Text direction for the theme */
+    direction?: 'ltr' | 'rtl';
+    /** Shape/geometry configuration for the theme */
+    shape?: FlowMetaThemeShape;
+    /** Typography configuration for the theme */
+    typography?: FlowMetaThemeTypography;
+}
+/**
+ * Resolved design configuration (theme and layout) for the flow.
+ *
+ * @experimental This API may change in future versions
+ */
+export interface DesignMetadata {
+    /** Resolved layout configuration (shape is server-defined) */
+    layout: Record<string, unknown>;
+    /** Resolved theme configuration for the flow */
+    theme: FlowMetaTheme;
+}
+/**
+ * Internationalisation metadata for the flow.
+ *
+ * @experimental This API may change in future versions
+ */
+export interface I18nMetadata {
+    /** The language used for the returned translations (defaults to `en`) */
+    language: string;
+    /** List of all available language tags (BCP 47) for the entity */
+    languages: string[];
+    /** Total number of translation keys returned */
+    totalResults?: number;
+    /**
+     * Translations organised by namespace.
+     *
+     * @example
+     * ```json
+     * {
+     *   "auth": {
+     *     "login.button": "Login",
+     *     "login.title": "Welcome"
+     *   }
+     * }
+     * ```
+     */
+    translations: Record<string, Record<string, string>>;
+}
+/**
+ * Aggregated flow metadata response returned by `GET /flow/meta`.
+ *
+ * @experimental This API may change in future versions
+ */
+export interface FlowMetadataResponse {
+    /**
+     * Application metadata.
+     * Only present when `type=APP`.
+     */
+    application?: ApplicationMetadata;
+    /** Resolved design configuration */
+    design: DesignMetadata;
+    /** Internationalisation metadata and translations */
+    i18n: I18nMetadata;
+    /** Indicates whether the registration flow is enabled for the entity */
+    is_registration_flow_enabled: boolean;
+    /**
+     * Organization unit metadata.
+     * Always present when `type=OU`.
+     * For `type=APP`, only present when the deployment has exactly one OU.
+     */
+    ou?: OUMetadata;
+}
+/**
+ * Request configuration for `getFlowMetaV2`.
+ *
+ * @example
+ * ```typescript
+ * const config: GetFlowMetaRequestConfig = {
+ *   baseUrl: 'https://localhost:8090',
+ *   type: FlowMetaType.App,
+ *   id: '60a9b38b-6eba-9f9e-55f9-267067de4680',
+ *   language: 'en',
+ *   namespace: 'auth',
+ * };
+ * ```
+ *
+ * @experimental This API may change in future versions
+ */
+export interface GetFlowMetaRequestConfig extends Omit<Partial<RequestInit>, 'method' | 'body'> {
+    /**
+     * Base URL of the Flow API server (e.g. `https://localhost:8090`).
+     * Either `baseUrl` or `url` must be provided.
+     */
+    baseUrl?: string;
+    /** UUID of the entity (application ID or organization unit ID) */
+    id: string;
+    /**
+     * Language tag in BCP 47 format for i18n translations.
+     * Defaults to `en` on the server side when omitted.
+     *
+     * @example "en", "es", "fr-CA"
+     */
+    language?: string;
+    /**
+     * Filter translations by a specific namespace.
+     *
+     * @example "auth", "errors", "common"
+     */
+    namespace?: string;
+    /** The type of entity to retrieve metadata for */
+    type: FlowMetaType;
+    /**
+     * Fully qualified URL of the `/flow/meta` endpoint.
+     * When provided, `baseUrl` is ignored.
+     */
+    url?: string;
+}

package/dist/models/v2/translation.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) 2026, 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.
+ */
+/**
+ * Generic translation function type.
+ *
+ * The default parameter type (`Record<string, string | number>`) matches the
+ * common i18n signature used throughout the SDK. Consumers can supply a more
+ * specific type when integrating with third-party i18n libraries.
+ *
+ * @template TParams - The type of the optional interpolation parameters object.
+ *
+ * @example
+ * // Using the default (SDK-native) signature
+ * const t: TranslationFn = (key, params) => i18n.t(key, params);
+ *
+ * // Using react-i18next's TFunction as TParams
+ * const t: TranslationFn<Record<string, unknown>> = i18nextT;
+ */
+export type TranslationFn<TParams = Record<string, string | number>> = (key: string, params?: TParams) => string;

package/dist/models/v2/vars.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2026, 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 { FlowMetadataResponse } from './flow-meta-v2';
+import { TranslationFn } from './translation';
+/**
+ * Options for the resolveVars function.
+ *
+ * @template TFn - The concrete translation function type.
+ *   Defaults to the SDK-native {@link TranslationFn} signature.
+ */
+export interface ResolveVarsOptions<TFn extends TranslationFn = TranslationFn> {
+    /**
+     * Optional flow metadata for resolving `{{ meta(path) }}` expressions.
+     */
+    meta?: FlowMetadataResponse | null;
+    /**
+     * i18n translation function for resolving `{{ t(key) }}` expressions.
+     */
+    t: TFn;
+}

package/dist/utils/v2/resolveMeta.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) 2026, 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 { FlowMetadataResponse } from '../../models/v2/flow-meta-v2';
+/**
+ * Resolves a dot-path expression against a FlowMetadataResponse object.
+ *
+ * Supports both camelCase paths (e.g. `logoUrl`) and snake_case API responses
+ * (e.g. `logo_url`). When a camelCase segment is not found directly, the
+ * function falls back to its snake_case equivalent.
+ *
+ * @example
+ * resolveMeta('application.name', meta) // → 'My App'
+ * resolveMeta('ou.name', meta)           // → 'My Org'
+ *
+ * @param path - Dot-separated path into the meta object (e.g. 'application.name')
+ * @param meta - The FlowMetadataResponse to look up
+ * @returns The resolved string value, or empty string if not found
+ */
+export default function resolveMeta(path: string, meta: FlowMetadataResponse): string;

package/dist/utils/v2/resolveVars.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Copyright (c) 2026, 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 { TranslationFn } from '../../models/v2/translation';
+import { ResolveVarsOptions } from '../../models/v2/vars';
+/**
+ * Resolves all template expressions in a string.
+ *
+ * Supported patterns:
+ *   - `{{ t(key) }}`       — resolved via the i18n translation function.
+ *                            Colon-separated namespaces are converted to dots:
+ *                            `{{ t(signin:heading.label) }}` → `t('signin.heading.label')`
+ *   - `{{ meta(path) }}`   — resolved via a dot-path lookup on FlowMetadataResponse.
+ *                            `{{ meta(application.name) }}` → `meta.application?.name`
+ *
+ * Template expressions can be embedded inside larger strings:
+ *   `"Login using {{ meta(application.name) }}"` → `"Login using My App"`
+ *
+ * Unrecognised expressions are left unchanged.
+ *
+ * @template TFn - The concrete translation function type.
+ *
+ * @param text - The string to resolve (may contain zero or more template expressions)
+ * @param options - Resolution context: translation function and optional flow metadata
+ * @returns The resolved string
+ */
+export default function resolveVars<TFn extends TranslationFn = TranslationFn>(text: string | undefined, { t, meta }: ResolveVarsOptions<TFn>): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asgardeo/javascript",
-  "version": "0.7.3",
+  "version": "0.8.1",
   "description": "Framework agnostic JavaScript SDK for Asgardeo.",
   "keywords": [
     "asgardeo",
@@ -35,8 +35,8 @@
   },
   "devDependencies": {
     "@types/node": "22.15.30",
-    "@wso2/eslint-plugin": "git+https://github.com/brionmario/wso2-ui-configs.git#a1fc6eb570653c999828aea9f5027cba06af4391&path:packages/eslint-plugin",
-    "@wso2/prettier-config": "git+https://github.com/brionmario/wso2-ui-configs.git#a1fc6eb570653c999828aea9f5027cba06af4391&path:packages/prettier-config",
+    "@wso2/eslint-plugin": "git+https://github.com/brionmario/wso2-ui-configs.git#d3041825a4f8f235c8f9fa36b55cf29d54e791c8&path:packages/eslint-plugin",
+    "@wso2/prettier-config": "git+https://github.com/brionmario/wso2-ui-configs.git#d3041825a4f8f235c8f9fa36b55cf29d54e791c8&path:packages/prettier-config",
     "esbuild": "0.25.9",
     "eslint": "8.57.0",
     "prettier": "2.6.2",
@@ -46,6 +46,7 @@
   },
   "dependencies": {
     "tslib": "2.8.1",
+    "jose": "^5.2.0",
     "@asgardeo/i18n": "0.4.2"
   },
   "publishConfig": {