Skip to content

Privacy-first password manager with built-in email aliasing. Fully encrypted and self-hostable.

Update identity generator calls to use Rust core in mobile app (#2279)

Leendert de Borst74893938fd72
diff --git a/apps/mobile-app/android/app/src/main/java/net/aliasvault/app/nativevaultmanager/NativeVaultManager.kt b/apps/mobile-app/android/app/src/main/java/net/aliasvault/app/nativevaultmanager/NativeVaultManager.kt
index 8d2bd84b6..6dd0420fa 100644
--- a/apps/mobile-app/android/app/src/main/java/net/aliasvault/app/nativevaultmanager/NativeVaultManager.kt
+++ b/apps/mobile-app/android/app/src/main/java/net/aliasvault/app/nativevaultmanager/NativeVaultManager.kt
@@ -1968,4 +1968,102 @@ class NativeVaultManager(reactContext: ReactApplicationContext) :
promise.reject("ERR_GET_DICEWARE_LANGUAGES", "Failed to get diceware languages: ${e.message}", e)
}
}
+
+ /**
+ * Generate a random identity from a JSON-serialized request.
+ * @param requestJson The JSON-serialized identity request (language, gender, ageRange).
+ * @param promise The promise to resolve with the identity as a JSON string.
+ */
+ @ReactMethod
+ override fun generateIdentity(requestJson: String, promise: Promise) {
+ try {
+ val identityJson = uniffi.aliasvault_core.generateIdentity(requestJson)
+ promise.resolve(identityJson)
+ } catch (e: Exception) {
+ Log.e(TAG, "Error generating identity", e)
+ promise.reject("ERR_GENERATE_IDENTITY", "Failed to generate identity: ${e.message}", e)
+ }
+ }
+
+ /**
+ * Generate a username from a JSON-serialized name input (firstName, lastName, birthDate).
+ * @param inputJson The JSON-serialized name input.
+ * @param promise The promise to resolve with the generated username.
+ */
+ @ReactMethod
+ override fun generateIdentityUsername(inputJson: String, promise: Promise) {
+ try {
+ val username = uniffi.aliasvault_core.generateIdentityUsername(inputJson)
+ promise.resolve(username)
+ } catch (e: Exception) {
+ Log.e(TAG, "Error generating identity username", e)
+ promise.reject("ERR_GENERATE_IDENTITY_USERNAME", "Failed to generate username: ${e.message}", e)
+ }
+ }
+
+ /**
+ * Generate an email prefix from a JSON-serialized name input (firstName, lastName, birthDate).
+ * @param inputJson The JSON-serialized name input.
+ * @param promise The promise to resolve with the generated email prefix.
+ */
+ @ReactMethod
+ override fun generateIdentityEmailPrefix(inputJson: String, promise: Promise) {
+ try {
+ val emailPrefix = uniffi.aliasvault_core.generateIdentityEmailPrefix(inputJson)
+ promise.resolve(emailPrefix)
+ } catch (e: Exception) {
+ Log.e(TAG, "Error generating identity email prefix", e)
+ promise.reject("ERR_GENERATE_IDENTITY_EMAIL_PREFIX", "Failed to generate email prefix: ${e.message}", e)
+ }
+ }
+
+ /**
+ * Generate a random alphanumeric email prefix that is not based on any identity.
+ * @param length The desired prefix length.
+ * @param promise The promise to resolve with the generated prefix.
+ */
+ @ReactMethod
+ override fun generateRandomEmailPrefix(length: Double, promise: Promise) {
+ try {
+ val prefix = uniffi.aliasvault_core.generateRandomEmailPrefix(length.toUInt())
+ promise.resolve(prefix)
+ } catch (e: Exception) {
+ Log.e(TAG, "Error generating random email prefix", e)
+ promise.reject("ERR_GENERATE_RANDOM_EMAIL_PREFIX", "Failed to generate random email prefix: ${e.message}", e)
+ }
+ }
+
+ /**
+ * List the bundled identity dictionary language codes.
+ * @param promise The promise to resolve with the array of language codes.
+ */
+ @ReactMethod
+ override fun getIdentityLanguages(promise: Promise) {
+ try {
+ val languages = uniffi.aliasvault_core.getIdentityLanguages()
+ val result = Arguments.createArray()
+ languages.forEach { result.pushString(it) }
+ promise.resolve(result)
+ } catch (e: Exception) {
+ Log.e(TAG, "Error getting identity languages", e)
+ promise.reject("ERR_GET_IDENTITY_LANGUAGES", "Failed to get identity languages: ${e.message}", e)
+ }
+ }
+
+ /**
+ * List the identity age range option values ("random" plus 5-year ranges).
+ * @param promise The promise to resolve with the array of age range values.
+ */
+ @ReactMethod
+ override fun getIdentityAgeRanges(promise: Promise) {
+ try {
+ val ageRanges = uniffi.aliasvault_core.getIdentityAgeRanges()
+ val result = Arguments.createArray()
+ ageRanges.forEach { result.pushString(it) }
+ promise.resolve(result)
+ } catch (e: Exception) {
+ Log.e(TAG, "Error getting identity age ranges", e)
+ promise.reject("ERR_GET_IDENTITY_AGE_RANGES", "Failed to get identity age ranges: ${e.message}", e)
+ }
+ }
}
diff --git a/apps/mobile-app/app/(tabs)/items/add-edit.tsx b/apps/mobile-app/app/(tabs)/items/add-edit.tsx
index 2faabb20f..f71bd7348 100644
--- a/apps/mobile-app/app/(tabs)/items/add-edit.tsx
+++ b/apps/mobile-app/app/(tabs)/items/add-edit.tsx
@@ -10,12 +10,14 @@ import { StyleSheet, View, Keyboard, Platform, ScrollView, KeyboardAvoidingView,
import Toast from 'react-native-toast-message';
import type { Folder } from '@/utils/db/repositories/FolderRepository';
-import { CreateIdentityGenerator, CreateUsernameEmailGenerator, UsernameEmailGenerator, Gender, Identity, IdentityHelperUtils, convertAgeRangeToBirthdateOptions } from '@/utils/dist/core/identity-generator';
+import type { Identity } from '@/utils/dist/core/models/identity';
+import { IdentityHelperUtils } from '@/utils/dist/core/models/identity';
import type { Attachment, Item, ItemField, TotpCode, ItemType, FieldType, PasswordSettings } from '@/utils/dist/core/models/vault';
import { ItemTypes, getSystemFieldsForItemType, getOptionalFieldsForItemType, isFieldShownByDefault, getSystemField, fieldAppliesToType, FieldCategories, FieldTypes } from '@/utils/dist/core/models/vault';
import type { FaviconExtractModel } from '@/utils/dist/core/models/webapi';
import emitter from '@/utils/EventEmitter';
import { HapticsUtility } from '@/utils/HapticsUtility';
+import * as IdentityGenerator from '@/utils/IdentityGeneratorUtility';
import * as PasswordGenerator from '@/utils/PasswordGeneratorUtility';
import { extractServiceNameFromUrl } from '@/utils/UrlUtility';
@@ -263,13 +265,14 @@ export default function AddEditItemScreen(): React.ReactNode {
*/
const generateRandomIdentity = useCallback(async (): Promise<Identity> => {
const identityLanguage = await dbContext.sqliteClient!.getEffectiveIdentityLanguage();
- const identityGenerator = CreateIdentityGenerator(identityLanguage);
-
const genderPreference = await dbContext.sqliteClient!.getDefaultIdentityGender();
const ageRange = await dbContext.sqliteClient!.getDefaultIdentityAgeRange();
- const birthdateOptions = convertAgeRangeToBirthdateOptions(ageRange);
- return identityGenerator.generateRandomIdentity(genderPreference, birthdateOptions);
+ return IdentityGenerator.generateIdentity({
+ language: identityLanguage,
+ gender: genderPreference,
+ ageRange
+ });
}, [dbContext.sqliteClient]);
/**
@@ -298,7 +301,7 @@ export default function AddEditItemScreen(): React.ReactNode {
newValues['alias.first_name'] = identity.firstName;
newValues['alias.last_name'] = identity.lastName;
newValues['alias.gender'] = identity.gender;
- newValues['alias.birthdate'] = IdentityHelperUtils.normalizeBirthDate(identity.birthDate.toISOString());
+ newValues['alias.birthdate'] = identity.birthDate;
// Only overwrite username if it's empty or matches the last generated value
if (!currentUsername || currentUsername === lastGeneratedValues.username) {
@@ -337,30 +340,7 @@ export default function AddEditItemScreen(): React.ReactNode {
const randomIdentity = await generateRandomIdentity();
username = randomIdentity.nickName;
} else {
- const usernameEmailGenerator = CreateUsernameEmailGenerator();
-
- let gender = Gender.Other;
- try {
- gender = (fieldValues['alias.gender'] as string) as Gender;
- } catch {
- // Gender parsing failed, default to other
- }
-
- let parsedBirthDate = new Date(birthDate);
- if (!birthDate || isNaN(parsedBirthDate.getTime())) {
- parsedBirthDate = new Date();
- }
-
- const identity: Identity = {
- firstName,
- lastName,
- nickName: '',
- gender,
- birthDate: parsedBirthDate,
- emailPrefix: (fieldValues['login.email'] as string) ?? '',
- };
-
- username = usernameEmailGenerator.generateUsername(identity);
+ username = await IdentityGenerator.generateIdentityUsername({ firstName, lastName, birthDate });
}
handleFieldChange('login.username', username);
@@ -379,24 +359,14 @@ export default function AddEditItemScreen(): React.ReactNode {
const firstName = (fieldValues['alias.first_name'] as string) || '';
const lastName = (fieldValues['alias.last_name'] as string) || '';
- const generator = new UsernameEmailGenerator();
let prefix: string;
if (!firstName.trim() && !lastName.trim()) {
// No alias identity fields filled in, fall back to random prefix.
- prefix = generator.generateRandomEmailPrefix();
+ prefix = await IdentityGenerator.generateRandomEmailPrefix();
} else {
- const gender = (fieldValues['alias.gender'] as string) || Gender.Other;
- const birthdate = (fieldValues['alias.birthdate'] as string) || '';
-
- prefix = generator.generateEmailPrefix({
- firstName,
- lastName,
- gender: gender as Gender,
- birthDate: birthdate ? new Date(birthdate) : new Date(),
- emailPrefix: '',
- nickName: ''
- });
+ const birthDate = (fieldValues['alias.birthdate'] as string) || '';
+ prefix = await IdentityGenerator.generateIdentityEmailPrefix({ firstName, lastName, birthDate });
}
const defaultEmailDomain = await dbContext.sqliteClient!.getDefaultEmailDomain();
@@ -411,8 +381,7 @@ export default function AddEditItemScreen(): React.ReactNode {
* has no persona fields to base the email on.
*/
const handleGenerateRandomEmail = useCallback(async () => {
- const generator = new UsernameEmailGenerator();
- const prefix = generator.generateRandomEmailPrefix();
+ const prefix = await IdentityGenerator.generateRandomEmailPrefix();
const defaultEmailDomain = await dbContext.sqliteClient!.getDefaultEmailDomain();
const email = defaultEmailDomain ? `${prefix}@${defaultEmailDomain}` : prefix;
diff --git a/apps/mobile-app/app/(tabs)/settings/identity-generator-language.tsx b/apps/mobile-app/app/(tabs)/settings/identity-generator-language.tsx
index 561180600..3b4add2d9 100644
--- a/apps/mobile-app/app/(tabs)/settings/identity-generator-language.tsx
+++ b/apps/mobile-app/app/(tabs)/settings/identity-generator-language.tsx
@@ -4,8 +4,8 @@ import { useState, useCallback, useRef } from 'react';
import { useTranslation } from 'react-i18next';
import { StyleSheet, View, TouchableOpacity } from 'react-native';
-import { getAvailableLanguages } from '@/utils/dist/core/identity-generator';
import { getLanguageInfo } from '@/utils/dist/core/models/defaults';
+import { getIdentityLanguages } from '@/utils/IdentityGeneratorUtility';
import { useColors } from '@/hooks/useColorScheme';
import { useVaultMutate } from '@/hooks/useVaultMutate';
@@ -29,9 +29,7 @@ export default function IdentityGeneratorLanguageScreen(): React.ReactNode {
const { executeVaultMutation } = useVaultMutate();
const [language, setLanguage] = useState<string>('en');
- const [languageOptions] = useState<string[]>(() =>
- getAvailableLanguages().sort((a, b) => getLanguageInfo(a).label.localeCompare(getLanguageInfo(b).label))
- );
+ const [languageOptions, setLanguageOptions] = useState<string[]>([]);
// Store pending changes and initial values
const pendingChanges = useRef<{ language?: string }>({});
@@ -44,7 +42,14 @@ export default function IdentityGeneratorLanguageScreen(): React.ReactNode {
*/
const loadSettings = async (): Promise<void> => {
try {
- const currentLanguage = await dbContext.sqliteClient!.getEffectiveIdentityLanguage();
+ const [currentLanguage, availableLanguages] = await Promise.all([
+ dbContext.sqliteClient!.getEffectiveIdentityLanguage(),
+ getIdentityLanguages()
+ ]);
+
+ setLanguageOptions(
+ [...availableLanguages].sort((a, b) => getLanguageInfo(a).label.localeCompare(getLanguageInfo(b).label))
+ );
setLanguage(currentLanguage);
initialValue.current = currentLanguage;
pendingChanges.current = {};
diff --git a/apps/mobile-app/app/(tabs)/settings/identity-generator.tsx b/apps/mobile-app/app/(tabs)/settings/identity-generator.tsx
index ca9b5f894..f12717254 100644
--- a/apps/mobile-app/app/(tabs)/settings/identity-generator.tsx
+++ b/apps/mobile-app/app/(tabs)/settings/identity-generator.tsx
@@ -4,8 +4,8 @@ import { useState, useCallback, useRef } from 'react';
import { useTranslation } from 'react-i18next';
import { StyleSheet, View, TouchableOpacity } from 'react-native';
-import { getAvailableAgeRanges, IAgeRangeOption } from '@/utils/dist/core/identity-generator';
import { getLanguageInfo } from '@/utils/dist/core/models/defaults';
+import { getIdentityAgeRanges } from '@/utils/IdentityGeneratorUtility';
import { useColors } from '@/hooks/useColorScheme';
import { useVaultMutate } from '@/hooks/useVaultMutate';
@@ -30,7 +30,7 @@ export default function IdentityGeneratorSettingsScreen(): React.ReactNode {
const [language, setLanguage] = useState<string>('en');
const [gender, setGender] = useState<string>('random');
const [ageRange, setAgeRange] = useState<string>('random');
- const [ageRangeOptions] = useState<IAgeRangeOption[]>(() => getAvailableAgeRanges());
+ const [ageRangeOptions, setAgeRangeOptions] = useState<string[]>([]);
// Store pending changes and initial values (language is managed in subview)
const pendingChanges = useRef<{ gender?: string; ageRange?: string }>({});
@@ -49,12 +49,15 @@ export default function IdentityGeneratorSettingsScreen(): React.ReactNode {
*/
const loadSettings = async (): Promise<void> => {
try {
- const [currentLanguage, currentGender, currentAgeRange] = await Promise.all([
+ const [currentLanguage, currentGender, currentAgeRange, availableAgeRanges] = await Promise.all([
dbContext.sqliteClient!.getEffectiveIdentityLanguage(),
dbContext.sqliteClient!.getDefaultIdentityGender(),
- dbContext.sqliteClient!.getDefaultIdentityAgeRange()
+ dbContext.sqliteClient!.getDefaultIdentityAgeRange(),
+ getIdentityAgeRanges()
]);
+ setAgeRangeOptions(availableAgeRanges);
+
setLanguage(currentLanguage);
setGender(currentGender);
setAgeRange(currentAgeRange);
@@ -252,17 +255,17 @@ export default function IdentityGeneratorSettingsScreen(): React.ReactNode {
<View style={styles.optionContainer}>
{ageRangeOptions.map((option, index) => {
const isLast = index === ageRangeOptions.length - 1;
- const displayLabel = option.value === 'random'
+ const displayLabel = option === 'random'
? t('settings.identityGeneratorSettings.genderOptions.random')
- : option.label;
+ : option;
return (
<TouchableOpacity
- key={option.value}
+ key={option}
style={[styles.option, isLast && styles.optionLast]}
- onPress={() => handleAgeRangeChange(option.value)}
+ onPress={() => handleAgeRangeChange(option)}
>
<ThemedText style={styles.optionText}>{displayLabel}</ThemedText>
- {ageRange === option.value && (
+ {ageRange === option && (
<Ionicons name="checkmark" size={20} style={styles.selectedIcon} />
)}
</TouchableOpacity>
diff --git a/apps/mobile-app/components/items/details/AliasDetails.tsx b/apps/mobile-app/components/items/details/AliasDetails.tsx
index c1fed2398..6bb602499 100644
--- a/apps/mobile-app/components/items/details/AliasDetails.tsx
+++ b/apps/mobile-app/components/items/details/AliasDetails.tsx
@@ -1,6 +1,6 @@
import { useTranslation } from 'react-i18next';
-import { IdentityHelperUtils } from '@/utils/dist/core/identity-generator';
+import { IdentityHelperUtils } from '@/utils/dist/core/models/identity';
import type { Item } from '@/utils/dist/core/models/vault';
import { getFieldValue, FieldKey } from '@/utils/dist/core/models/vault';
diff --git a/apps/mobile-app/ios/NativeVaultManager/RCTNativeVaultManager.mm b/apps/mobile-app/ios/NativeVaultManager/RCTNativeVaultManager.mm
index 04ab8f729..c9d887ebf 100644
--- a/apps/mobile-app/ios/NativeVaultManager/RCTNativeVaultManager.mm
+++ b/apps/mobile-app/ios/NativeVaultManager/RCTNativeVaultManager.mm
@@ -345,6 +345,32 @@
[vaultManager getDicewareLanguages:resolve rejecter:reject];
}
+// MARK: - Identity Generator
+
+- (void)generateIdentity:(NSString *)requestJson resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject {
+ [vaultManager generateIdentity:requestJson resolver:resolve rejecter:reject];
+}
+
+- (void)generateIdentityUsername:(NSString *)inputJson resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject {
+ [vaultManager generateIdentityUsername:inputJson resolver:resolve rejecter:reject];
+}
+
+- (void)generateIdentityEmailPrefix:(NSString *)inputJson resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject {
+ [vaultManager generateIdentityEmailPrefix:inputJson resolver:resolve rejecter:reject];
+}
+
+- (void)generateRandomEmailPrefix:(double)length resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject {
+ [vaultManager generateRandomEmailPrefix:length resolver:resolve rejecter:reject];
+}
+
+- (void)getIdentityLanguages:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject {
+ [vaultManager getIdentityLanguages:resolve rejecter:reject];
+}
+
+- (void)getIdentityAgeRanges:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject {
+ [vaultManager getIdentityAgeRanges:resolve rejecter:reject];
+}
+
// MARK: - SRP (Secure Remote Password) Operations
- (void)srpGenerateSalt:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject {
diff --git a/apps/mobile-app/ios/NativeVaultManager/VaultManager.swift b/apps/mobile-app/ios/NativeVaultManager/VaultManager.swift
index 86ab325a4..f3793a9f9 100644
--- a/apps/mobile-app/ios/NativeVaultManager/VaultManager.swift
+++ b/apps/mobile-app/ios/NativeVaultManager/VaultManager.swift
@@ -1313,6 +1313,73 @@ public class VaultManager: NSObject {
resolve(languages)
}
+ // MARK: - Identity Generator
+
+ /// Generate a random identity from a JSON-serialized request.
+ /// Returns the generated identity as a JSON string with camelCase fields.
+ @objc
+ func generateIdentity(_ requestJson: String,
+ resolver resolve: @escaping RCTPromiseResolveBlock,
+ rejecter reject: @escaping RCTPromiseRejectBlock) {
+ do {
+ let identityJson = try RustCoreFramework.generateIdentity(requestJson: requestJson)
+ resolve(identityJson)
+ } catch {
+ reject("IDENTITY_GENERATOR_ERROR", "Failed to generate identity: \(error.localizedDescription)", error)
+ }
+ }
+
+ /// Generate a username from a JSON-serialized name input (firstName, lastName, birthDate).
+ @objc
+ func generateIdentityUsername(_ inputJson: String,
+ resolver resolve: @escaping RCTPromiseResolveBlock,
+ rejecter reject: @escaping RCTPromiseRejectBlock) {
+ do {
+ let username = try RustCoreFramework.generateIdentityUsername(inputJson: inputJson)
+ resolve(username)
+ } catch {
+ reject("IDENTITY_GENERATOR_ERROR", "Failed to generate username: \(error.localizedDescription)", error)
+ }
+ }
+
+ /// Generate an email prefix from a JSON-serialized name input (firstName, lastName, birthDate).
+ @objc
+ func generateIdentityEmailPrefix(_ inputJson: String,
+ resolver resolve: @escaping RCTPromiseResolveBlock,
+ rejecter reject: @escaping RCTPromiseRejectBlock) {
+ do {
+ let emailPrefix = try RustCoreFramework.generateIdentityEmailPrefix(inputJson: inputJson)
+ resolve(emailPrefix)
+ } catch {
+ reject("IDENTITY_GENERATOR_ERROR", "Failed to generate email prefix: \(error.localizedDescription)", error)
+ }
+ }
+
+ /// Generate a random alphanumeric email prefix that is not based on any identity.
+ @objc
+ func generateRandomEmailPrefix(_ length: Double,
+ resolver resolve: @escaping RCTPromiseResolveBlock,
+ rejecter reject: @escaping RCTPromiseRejectBlock) {
+ let prefix = RustCoreFramework.generateRandomEmailPrefix(length: UInt32(length))
+ resolve(prefix)
+ }
+
+ /// List the bundled identity dictionary language codes.
+ @objc
+ func getIdentityLanguages(_ resolve: @escaping RCTPromiseResolveBlock,
+ rejecter reject: @escaping RCTPromiseRejectBlock) {
+ let languages = RustCoreFramework.getIdentityLanguages()
+ resolve(languages)
+ }
+
+ /// List the identity age range option values ("random" plus 5-year ranges).
+ @objc
+ func getIdentityAgeRanges(_ resolve: @escaping RCTPromiseResolveBlock,
+ rejecter reject: @escaping RCTPromiseRejectBlock) {
+ let ageRanges = RustCoreFramework.getIdentityAgeRanges()
+ resolve(ageRanges)
+ }
+
// MARK: - SRP (Secure Remote Password) Operations
/// Generate a cryptographic salt for SRP.
diff --git a/apps/mobile-app/specs/NativeVaultManager.ts b/apps/mobile-app/specs/NativeVaultManager.ts
index 25e7b88bd..4e6c0e175 100644
--- a/apps/mobile-app/specs/NativeVaultManager.ts
+++ b/apps/mobile-app/specs/NativeVaultManager.ts
@@ -142,6 +142,22 @@ export interface Spec extends TurboModule {
// List the bundled Diceware wordlist language codes (first is the default, English).
getDicewareLanguages(): Promise<string[]>;
+ // Identity generator (uses the native Rust core, shared with the other AliasVault clients)
+ // Generate a random identity from a JSON-serialized request
+ // (e.g. {"language":"en","gender":"random","ageRange":"21-25"}).
+ // Returns the identity as a JSON string with camelCase fields.
+ generateIdentity(requestJson: string): Promise<string>;
+ // Generate a username from a JSON-serialized name input ({"firstName","lastName","birthDate"}).
+ generateIdentityUsername(inputJson: string): Promise<string>;
+ // Generate an email prefix from a JSON-serialized name input ({"firstName","lastName","birthDate"}).
+ generateIdentityEmailPrefix(inputJson: string): Promise<string>;
+ // Generate a random alphanumeric email prefix that is not based on any identity.
+ generateRandomEmailPrefix(length: number): Promise<string>;
+ // List the bundled identity dictionary language codes.
+ getIdentityLanguages(): Promise<string[]>;
+ // List the identity age range option values ("random" plus 5-year ranges).
+ getIdentityAgeRanges(): Promise<string[]>;
+
// SRP (Secure Remote Password) operations
// These methods use the native Rust SRP implementation for secure authentication.
// All hex values are uppercase strings.
diff --git a/apps/mobile-app/utils/IdentityGeneratorUtility.ts b/apps/mobile-app/utils/IdentityGeneratorUtility.ts
new file mode 100644
index 000000000..65b521bac
--- /dev/null
+++ b/apps/mobile-app/utils/IdentityGeneratorUtility.ts
@@ -0,0 +1,89 @@
+/**
+ * Typed wrapper around the native Rust core for identity (alias persona) generation.
+ */
+import NativeVaultManager from '@/specs/NativeVaultManager';
+import type { Identity } from '@/utils/dist/core/models/identity';
+
+/**
+ * Request for {@link generateIdentity}. All fields except `language` are optional.
+ */
+export type IdentityRequest = {
+ /** Dictionary language code (e.g. 'en'); unknown codes fall back to English. */
+ language: string;
+ /** Gender preference: 'male', 'female' or 'random' (default). */
+ gender?: string;
+ /** Age range preference as stored in settings (e.g. '21-25' or 'random'). */
+ ageRange?: string;
+};
+
+/**
+ * Name and birth date input for identity-based username/email prefix generation.
+ */
+export type IdentityNameInput = {
+ firstName: string;
+ lastName: string;
+ /** Birth date; only the leading yyyy year part is used. */
+ birthDate: string;
+};
+
+/**
+ * Generate a random identity (alias persona) in the Rust core.
+ *
+ * @param request The identity request (language, gender, ageRange).
+ * @returns The generated identity with a yyyy-MM-dd birth date string.
+ */
+export async function generateIdentity(request: IdentityRequest): Promise<Identity> {
+ const identityJson = await NativeVaultManager.generateIdentity(JSON.stringify(request));
+ return JSON.parse(identityJson) as Identity;
+}
+
+/**
+ * Generate a username from persona name fields (alphanumeric, 6-20 characters).
+ *
+ * @param input The name input (firstName, lastName, birthDate).
+ * @returns The generated username.
+ */
+export async function generateIdentityUsername(input: IdentityNameInput): Promise<string> {
+ return NativeVaultManager.generateIdentityUsername(JSON.stringify(input));
+}
+
+/**
+ * Generate an email prefix from persona name fields (6-20 characters).
+ *
+ * @param input The name input (firstName, lastName, birthDate).
+ * @returns The generated email prefix.
+ */
+export async function generateIdentityEmailPrefix(input: IdentityNameInput): Promise<string> {
+ return NativeVaultManager.generateIdentityEmailPrefix(JSON.stringify(input));
+}
+
+/**
+ * Generate a random alphanumeric email prefix that is not based on any identity.
+ * Used for login-type credentials where no persona fields are available.
+ *
+ * @param length The desired prefix length.
+ * @returns The generated prefix.
+ */
+export async function generateRandomEmailPrefix(length: number = 14): Promise<string> {
+ return NativeVaultManager.generateRandomEmailPrefix(length);
+}
+
+/**
+ * Get the list of bundled identity dictionary language ISO codes.
+ * The set is owned by the Rust core; unknown codes fall back to English during generation.
+ *
+ * @returns The available language codes.
+ */
+export async function getIdentityLanguages(): Promise<string[]> {
+ const languages = await NativeVaultManager.getIdentityLanguages();
+ return languages.length > 0 ? languages : ['en'];
+}
+
+/**
+ * Get the list of identity age range option values ('random' plus 5-year ranges).
+ *
+ * @returns The available age range values.
+ */
+export async function getIdentityAgeRanges(): Promise<string[]> {
+ return NativeVaultManager.getIdentityAgeRanges();
+}
diff --git a/apps/mobile-app/utils/SqliteClient.ts b/apps/mobile-app/utils/SqliteClient.ts
index 0f7d34b4c..9f9071a37 100644
--- a/apps/mobile-app/utils/SqliteClient.ts
+++ b/apps/mobile-app/utils/SqliteClient.ts
@@ -341,12 +341,12 @@ class SqliteClient implements IDatabaseClient {
// Otherwise, match the UI language to one of the identity generator's available languages using
// the shared region-variant alternative-code table (e.g. "de-CH" -> "de").
- const { getAvailableLanguages } = await import('@/utils/dist/core/identity-generator');
+ const { getIdentityLanguages } = await import('@/utils/IdentityGeneratorUtility');
const { matchAvailableLanguage } = await import('@/utils/dist/core/models/defaults');
const { default: i18n } = await import('@/i18n');
const uiLanguage = i18n.language;
- const mappedLanguage = matchAvailableLanguage(uiLanguage, getAvailableLanguages());
+ const mappedLanguage = matchAvailableLanguage(uiLanguage, await getIdentityLanguages());
// Return the mapped language, or fall back to "en" if no match found
return mappedLanguage ?? 'en';
diff --git a/apps/mobile-app/utils/dist/core/models/identity/index.d.ts b/apps/mobile-app/utils/dist/core/models/identity/index.d.ts
new file mode 100644
index 000000000..6c9e9ff3e
--- /dev/null
+++ b/apps/mobile-app/utils/dist/core/models/identity/index.d.ts
@@ -0,0 +1,42 @@
+/**
+ * Gender values used by generated identities and alias persona fields.
+ * Matches the string values produced by the Rust core identity generator.
+ */
+declare enum Gender {
+ Male = "Male",
+ Female = "Female",
+ Other = "Other"
+}
+
+/**
+ * A generated identity as returned by the Rust core identity generator
+ * (JSON with camelCase fields).
+ */
+type Identity = {
+ firstName: string;
+ lastName: string;
+ gender: Gender | string;
+ /** Birth date in yyyy-MM-dd format. */
+ birthDate: string;
+ emailPrefix: string;
+ /** Username derived from the name and birth year (alphanumeric only). */
+ nickName: string;
+};
+
+/**
+ * Helper utilities for working with identity birth dates in the client UIs.
+ */
+declare class IdentityHelperUtils {
+ /**
+ * Normalize a birth date to the standard format: "yyyy-MM-dd".
+ * Handles various input formats including ISO strings with time components.
+ * Returns empty string for invalid/empty dates.
+ */
+ static normalizeBirthDate(input: string | undefined): string;
+ /**
+ * Check if a birth date is valid.
+ */
+ static isValidBirthDate(input: string | undefined): boolean;
+}
+
+export { Gender, type Identity, IdentityHelperUtils };
diff --git a/apps/mobile-app/utils/dist/core/models/identity/index.js b/apps/mobile-app/utils/dist/core/models/identity/index.js
new file mode 100644
index 000000000..60524e3fd
--- /dev/null
+++ b/apps/mobile-app/utils/dist/core/models/identity/index.js
@@ -0,0 +1,58 @@
+// <auto-generated>
+// This file was automatically generated. Do not edit manually.
+
+
+// src/identity/Gender.ts
+var Gender = /* @__PURE__ */ ((Gender2) => {
+ Gender2["Male"] = "Male";
+ Gender2["Female"] = "Female";
+ Gender2["Other"] = "Other";
+ return Gender2;
+})(Gender || {});
+
+// src/identity/IdentityHelperUtils.ts
+var IdentityHelperUtils = class {
+ /**
+ * Normalize a birth date to the standard format: "yyyy-MM-dd".
+ * Handles various input formats including ISO strings with time components.
+ * Returns empty string for invalid/empty dates.
+ */
+ static normalizeBirthDate(input) {
+ if (!input || input.trim() === "" || input.startsWith("0001-01-01")) {
+ return "";
+ }
+ const trimmed = input.trim();
+ const match = trimmed.match(/^(\d{4})-(\d{2})-(\d{2})/);
+ if (match) {
+ const [, y, m, d] = match;
+ return `${y}-${m}-${d}`;
+ }
+ const parsedDate = new Date(trimmed);
+ if (!isNaN(parsedDate.getTime())) {
+ const year = parsedDate.getFullYear().toString().padStart(4, "0");
+ const month = (parsedDate.getMonth() + 1).toString().padStart(2, "0");
+ const day = parsedDate.getDate().toString().padStart(2, "0");
+ return `${year}-${month}-${day}`;
+ }
+ return "";
+ }
+ /**
+ * Check if a birth date is valid.
+ */
+ static isValidBirthDate(input) {
+ if (!input || input.trim() === "") {
+ return false;
+ }
+ if (input.startsWith("0001-01-01")) {
+ return false;
+ }
+ const date = new Date(input);
+ if (isNaN(date.getTime())) {
+ return false;
+ }
+ const yearValid = date.getFullYear() > 1 && date.getFullYear() < 9999;
+ return yearValid;
+ }
+};
+
+export { Gender, IdentityHelperUtils };
diff --git a/core/models/src/identity/Identity.ts b/core/models/src/identity/Identity.ts
index da26b267c..e0b25f679 100644
--- a/core/models/src/identity/Identity.ts
+++ b/core/models/src/identity/Identity.ts
@@ -2,8 +2,7 @@ import type { Gender } from './Gender';
/**
* A generated identity as returned by the Rust core identity generator
- * (JSON with camelCase fields).
- */
+*/
export type Identity = {
firstName: string;
lastName: string;