@asgardeo/vue 0.0.9 → 0.1.0

package/dist/components/primitives/Spinner/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+export { default } from './Spinner';

package/dist/components/primitives/TextField/TextField.css.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ */
+/**
+ * Styles for the TextField primitive component.
+ *
+ * BEM block: `.asgardeo-text-field`
+ *
+ * Modifiers:
+ *   --error  – shows validation error state
+ *
+ * Elements:
+ *   __label | __required | __input | __error | __helper
+ */
+declare const TEXT_FIELD_CSS: string;
+export default TEXT_FIELD_CSS;

package/dist/components/primitives/TextField/TextField.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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 { type Component } from 'vue';
+declare const TextField: Component;
+export default TextField;

package/dist/components/primitives/TextField/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+export { default } from './TextField';

package/dist/components/primitives/Typography/Typography.css.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ */
+/**
+ * Styles for the Typography primitive component.
+ *
+ * BEM block: `.asgardeo-typography`
+ *
+ * Modifiers (variant):
+ *   --h1 | --h2 | --h3 | --h4 | --h5 | --h6
+ *   --subtitle1 | --subtitle2
+ *   --body1 | --body2
+ *   --caption | --overline
+ */
+declare const TYPOGRAPHY_CSS: string;
+export default TYPOGRAPHY_CSS;

package/dist/components/primitives/Typography/Typography.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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 { type Component } from 'vue';
+declare const Typography: Component;
+export default Typography;

package/dist/components/primitives/Typography/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+export { default } from './Typography';

package/dist/composables/useAsgardeo.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 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 type { AsgardeoContext } from '../models/contexts';
+/**
+ * Primary composable for Asgardeo authentication.
+ *
+ * Must be called inside a component that is a descendant of `<AsgardeoProvider>`.
+ * Returns all auth-related reactive state and action methods.
+ *
+ * @throws Error if called outside of `<AsgardeoProvider>`.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useAsgardeo } from '@asgardeo/vue';
+ *
+ * const { isSignedIn, isLoading, user, signIn, signOut } = useAsgardeo();
+ * </script>
+ *
+ * <template>
+ *   <div v-if="isLoading">Loading...</div>
+ *   <div v-else-if="isSignedIn">
+ *     <p>Welcome, {{ user?.name }}</p>
+ *     <button @click="signOut()">Sign Out</button>
+ *   </div>
+ *   <div v-else>
+ *     <button @click="signIn()">Sign In</button>
+ *   </div>
+ * </template>
+ * ```
+ */
+declare const useAsgardeo: () => AsgardeoContext;
+export default useAsgardeo;

package/dist/composables/useBranding.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 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 type { BrandingContextValue } from '../models/contexts';
+/**
+ * Composable for accessing branding preference data.
+ *
+ * Must be called inside a component that is a descendant of `<AsgardeoProvider>`.
+ *
+ * @returns {BrandingContextValue} The branding context with preferences, theme, and fetch operations.
+ * @throws {Error} If called outside of `<AsgardeoProvider>`.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useBranding } from '@asgardeo/vue';
+ *
+ * const { brandingPreference, theme, isLoading, fetchBranding } = useBranding();
+ * </script>
+ *
+ * <template>
+ *   <div v-if="!isLoading">
+ *     <img :src="brandingPreference?.images?.logo?.imgURL" alt="Logo" />
+ *   </div>
+ * </template>
+ * ```
+ */
+declare const useBranding: () => BrandingContextValue;
+export default useBranding;

package/dist/composables/useFlow.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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 type { FlowContextValue } from '../models/contexts';
+/**
+ * Composable for managing authentication flow UI state.
+ *
+ * Must be called inside a component that is a descendant of `<AsgardeoProvider>`.
+ *
+ * @returns {FlowContextValue} The flow context with step navigation, messages, and loading state.
+ * @throws {Error} If called outside of `<AsgardeoProvider>`.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useFlow } from '@asgardeo/vue';
+ *
+ * const { currentStep, isLoading, messages, navigateToFlow, reset } = useFlow();
+ * </script>
+ *
+ * <template>
+ *   <div>
+ *     <p v-if="isLoading">Loading...</p>
+ *     <component :is="currentStep?.component" v-else />
+ *     <p v-for="msg in messages" :key="msg.id">{{ msg.content }}</p>
+ *   </div>
+ * </template>
+ * ```
+ */
+declare const useFlow: () => FlowContextValue;
+export default useFlow;

package/dist/composables/useFlowMeta.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 type { FlowMetaContextValue } from '../models/contexts';
+/**
+ * Composable for accessing flow metadata.
+ *
+ * Must be called inside a component that is a descendant of `<AsgardeoProvider>`.
+ *
+ * @returns {FlowMetaContextValue} The flow meta context with metadata, loading state, and language switching.
+ * @throws {Error} If called outside of `<AsgardeoProvider>`.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useFlowMeta } from '@asgardeo/vue';
+ *
+ * const { meta, isLoading, switchLanguage } = useFlowMeta();
+ *
+ * async function changeLanguage(lang: string) {
+ *   await switchLanguage(lang);
+ * }
+ * </script>
+ * ```
+ */
+declare const useFlowMeta: () => FlowMetaContextValue;
+export default useFlowMeta;

package/dist/composables/useI18n.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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 type { I18nContextValue } from '../models/contexts';
+/**
+ * Composable for accessing internationalization utilities.
+ *
+ * Must be called inside a component that is a descendant of `<AsgardeoProvider>`.
+ *
+ * @returns {I18nContextValue} The i18n context with translation function, language management, and bundle injection.
+ * @throws {Error} If called outside of `<AsgardeoProvider>`.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useI18n } from '@asgardeo/vue';
+ *
+ * const { t, currentLanguage, setLanguage } = useI18n();
+ * </script>
+ *
+ * <template>
+ *   <p>{{ t('common.welcome') }}</p>
+ *   <select :value="currentLanguage" @change="setLanguage($event.target.value)">
+ *     <option value="en-US">English</option>
+ *     <option value="fr-FR">Français</option>
+ *   </select>
+ * </template>
+ * ```
+ */
+declare const useI18n: () => I18nContextValue;
+export default useI18n;

package/dist/composables/useOAuthCallback.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 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 { type Ref } from 'vue';
+export interface UseOAuthCallbackOptions {
+    /** Current flowId from component state */
+    currentFlowId: Ref<string | null>;
+    /** SessionStorage key for flowId (defaults to 'asgardeo_flow_id') */
+    flowIdStorageKey?: string;
+    /** Whether the component is initialized and ready to process OAuth callback */
+    isInitialized: Ref<boolean>;
+    /** Whether a submission is currently in progress */
+    isSubmitting?: Ref<boolean>;
+    /** Callback when OAuth flow completes successfully */
+    onComplete?: () => void;
+    /** Callback when OAuth flow encounters an error */
+    onError?: (error: any) => void;
+    /** Callback to handle flow response after submission */
+    onFlowChange?: (response: any) => void;
+    /** Callback to set loading state at the start of OAuth processing */
+    onProcessingStart?: () => void;
+    /** Function to submit OAuth code to the server */
+    onSubmit: (payload: OAuthCallbackPayload) => Promise<any>;
+    /** Mutable flag to track whether OAuth has already been processed */
+    processedFlag?: {
+        value: boolean;
+    };
+    /** Additional handler for setting state (e.g., setFlowId) */
+    setFlowId?: (flowId: string) => void;
+    /**
+     * Mutable flag for token validation tracking.
+     * Used in AcceptInvite to coordinate between OAuth callback and token validation.
+     */
+    tokenValidationAttemptedFlag?: {
+        value: boolean;
+    };
+}
+export interface OAuthCallbackPayload {
+    flowId: string;
+    inputs: {
+        code: string;
+        nonce?: string;
+    };
+}
+/**
+ * Processes OAuth callbacks by detecting auth code in URL, resolving flowId, and submitting to server.
+ * Used by SignIn, SignUp, and AcceptInvite components.
+ *
+ * Vue composable equivalent of React's useOAuthCallback hook.
+ */
+export declare function useOAuthCallback({ currentFlowId, flowIdStorageKey, isInitialized, isSubmitting, onComplete, onError, onFlowChange, onProcessingStart, onSubmit, processedFlag, setFlowId, tokenValidationAttemptedFlag, }: UseOAuthCallbackOptions): void;

package/dist/composables/useOrganization.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 type { OrganizationContextValue } from '../models/contexts';
+/**
+ * Composable for accessing organization data and operations.
+ *
+ * Must be called inside a component that is a descendant of `<AsgardeoProvider>`.
+ *
+ * @returns {OrganizationContextValue} The organization context.
+ * @throws {Error} If called outside of `<AsgardeoProvider>`.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useOrganization } from '@asgardeo/vue';
+ *
+ * const { myOrganizations, currentOrganization, switchOrganization } = useOrganization();
+ *
+ * async function handleSwitch(orgId: string) {
+ *   await switchOrganization(orgId);
+ * }
+ * </script>
+ * ```
+ */
+declare const useOrganization: () => OrganizationContextValue;
+export default useOrganization;

package/dist/composables/useTheme.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 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 type { ThemeContextValue } from '../models/contexts';
+/**
+ * Composable for accessing and controlling the active theme.
+ *
+ * Must be called inside a component that is a descendant of `<AsgardeoProvider>`.
+ *
+ * @returns {ThemeContextValue} The theme context with the active theme, color scheme, and toggle function.
+ * @throws {Error} If called outside of `<AsgardeoProvider>`.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useTheme } from '@asgardeo/vue';
+ *
+ * const { theme, colorScheme, toggleTheme } = useTheme();
+ * </script>
+ *
+ * <template>
+ *   <button @click="toggleTheme()">
+ *     Switch to {{ colorScheme === 'light' ? 'dark' : 'light' }} mode
+ *   </button>
+ * </template>
+ * ```
+ */
+declare const useTheme: () => ThemeContextValue;
+export default useTheme;

package/dist/composables/useUser.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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 type { UserContextValue } from '../models/contexts';
+/**
+ * Composable for accessing user profile data.
+ *
+ * Must be called inside a component that is a descendant of `<AsgardeoProvider>`.
+ *
+ * @returns {UserContextValue} The user context containing profile, schemas, and update operations.
+ * @throws {Error} If called outside of `<AsgardeoProvider>`.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useUser } from '@asgardeo/vue';
+ *
+ * const { profile, flattenedProfile, schemas, updateProfile, revalidateProfile } = useUser();
+ * </script>
+ *
+ * <template>
+ *   <div v-if="profile">
+ *     <p>Name: {{ flattenedProfile?.name }}</p>
+ *     <button @click="revalidateProfile()">Refresh</button>
+ *   </div>
+ * </template>
+ * ```
+ */
+declare const useUser: () => UserContextValue;
+export default useUser;