@asgardeo/javascript 0.8.0 → 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/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/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.1",
   "description": "Framework agnostic JavaScript SDK for Asgardeo.",
   "keywords": [
     "asgardeo",
@@ -46,6 +46,7 @@
   },
   "dependencies": {
     "tslib": "2.8.1",
+    "jose": "^5.2.0",
     "@asgardeo/i18n": "0.4.2"
   },
   "publishConfig": {