@asgardeo/javascript 0.8.0 → 0.8.2

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

@@ -239,6 +239,16 @@ export interface ThemePreferences {
      */
     overrides?: RecursivePartial<ThemeConfig>;
 }
+/**
+ * The storage strategy to use for persisting the user's language selection.
+ *
+ * - `'cookie'`       — persists in `document.cookie` as a domain cookie (default).
+ *                      Useful for cross-subdomain scenarios where the auth portal and
+ *                      the application share a root domain.
+ * - `'localStorage'` — persists in `window.localStorage`.
+ * - `'none'`         — no persistence; the resolved language is held in React state only.
+ */
+export type I18nStorageStrategy = 'cookie' | 'localStorage' | 'none';
 export interface I18nPreferences {
     /**
      * Custom translations to override default ones.
@@ -246,6 +256,14 @@ export interface I18nPreferences {
     bundles?: {
         [key: string]: I18nBundle;
     };
+    /**
+     * The domain to use when setting the language cookie.
+     * Only applies when `storageStrategy` is `'cookie'`.
+     * Defaults to the root domain derived from `window.location.hostname`
+     * (e.g. `'app.example.com'` → `'example.com'`).
+     * Override this for eTLD+1 domains like `.co.uk` or custom cookie scoping.
+     */
+    cookieDomain?: string;
     /**
      * The fallback language to use if translations are not available in the specified language.
      * Defaults to 'en-US'.
@@ -253,9 +271,31 @@ export interface I18nPreferences {
     fallbackLanguage?: string;
     /**
      * The language to use for translations.
-     * Defaults to the browser's default language.
+     * When set, acts as a hard override and bypasses all other detection sources
+     * (URL param, stored preference, browser language).
      */
     language?: string;
+    /**
+     * The key used when reading/writing the language to the chosen storage.
+     * For `localStorage` this is the key name; for `cookie` this is the cookie name.
+     * @default 'asgardeo-i18n-language'
+     */
+    storageKey?: string;
+    /**
+     * The storage strategy to use for persisting the user's language selection.
+     * @default 'cookie'
+     */
+    storageStrategy?: I18nStorageStrategy;
+    /**
+     * The URL query-parameter name to inspect for a language override.
+     * Set to `false` to disable URL-parameter detection entirely.
+     * When a URL param is detected its value is immediately persisted to storage.
+     * @default 'lang'
+     * @example
+     * // With urlParam: 'locale', the URL ?locale=fr-FR will select French.
+     * // With urlParam: false, URL parameters are ignored.
+     */
+    urlParam?: string | false;
 }
 export interface Preferences {
     /**

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

@@ -137,7 +137,7 @@ export interface FlowMetaThemeColors {
  */
 export interface FlowMetaThemeColorScheme {
     /** All colors defined for this color scheme (light or dark) */
-    colors: FlowMetaThemeColors;
+    palette: FlowMetaThemeColors;
 }
 /**
  * Shape / geometry configuration in the v2 theme.

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/countryCodeToFlagEmoji.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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.
+ */
+/**
+ * Converts a two-letter ISO 3166-1 alpha-2 country code to a flag emoji using
+ * Unicode Regional Indicator Symbols (U+1F1E6–U+1F1FF).
+ *
+ * @param countryCode - Two-letter uppercase country code (e.g. "US", "GB")
+ * @returns Flag emoji string (e.g. "🇺🇸", "🇬🇧")
+ */
+export default function countryCodeToFlagEmoji(countryCode: string): string;

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

@@ -0,0 +1,29 @@
+/**
+ * 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.
+ */
+/**
+ * Resolves a BCP 47 locale tag to a human-readable display name using the
+ * `Intl.DisplayNames` API.
+ *
+ * Falls back to the raw locale code if the runtime does not support
+ * `Intl.DisplayNames` or if resolution returns `undefined`.
+ *
+ * @param locale - BCP 47 locale tag to resolve (e.g. "en", "fr", "zh-Hant")
+ * @param displayLocale - Locale used for the display name language (defaults to "en")
+ * @returns Human-readable language name (e.g. "English", "French")
+ */
+export default function resolveLocaleDisplayName(locale: string, displayLocale: string): string;

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

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ */
+/**
+ * Resolves a BCP 47 locale tag to a flag emoji.
+ *
+ * Resolution order:
+ * 1. Country subtag when present (e.g. `"en-US"` → 🇺🇸)
+ * 2. Language-to-country fallback map (e.g. `"en"` → 🇬🇧)
+ * 3. Globe emoji 🌐 for unrecognised codes
+ *
+ * @param locale - BCP 47 locale tag (e.g. "en", "en-US", "fr-CA")
+ * @returns Flag or globe emoji string
+ */
+declare function resolveLocaleEmoji(locale: string): string;
+export default resolveLocaleEmoji;

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.8.0",
+  "version": "0.8.2",
   "description": "Framework agnostic JavaScript SDK for Asgardeo.",
   "keywords": [
     "asgardeo",
@@ -46,7 +46,8 @@
   },
   "dependencies": {
     "tslib": "2.8.1",
-    "@asgardeo/i18n": "0.4.2"
+    "jose": "^5.2.0",
+    "@asgardeo/i18n": "0.4.3"
   },
   "publishConfig": {
     "access": "public"