Skip to content

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

Add .avux export scaffolding (#773)

Leendert de Borst417350178993
diff --git a/apps/server/AliasVault.Client/Main/Pages/Settings/ImportExport/ImportExport.razor b/apps/server/AliasVault.Client/Main/Pages/Settings/ImportExport/ImportExport.razor
index d3d9005e5..dd2337af6 100644
--- a/apps/server/AliasVault.Client/Main/Pages/Settings/ImportExport/ImportExport.razor
+++ b/apps/server/AliasVault.Client/Main/Pages/Settings/ImportExport/ImportExport.razor
@@ -10,6 +10,8 @@
@using AliasVault.Client.Services.Auth
@using AliasVault.Client.Services.Auth.Enums
@using AliasVault.ImportExport
+@using Microsoft.EntityFrameworkCore
+@using AliasClientDb
<LayoutPageTitle>@Localizer["PageTitle"]</LayoutPageTitle>
@@ -57,6 +59,9 @@
<div class="mt-6">
<Button OnClick="@(() => ShowExportConfirmation(ExportType.Sqlite))">@Localizer["ExportSqliteButton"]</Button>
</div>
+ <div class="mt-6">
+ <Button OnClick="@(() => ShowExportConfirmation(ExportType.Avux))">@Localizer["ExportAvuxButton"]</Button>
+ </div>
</div>
</div>
@@ -80,7 +85,8 @@
private enum ExportType
{
Csv,
- Sqlite
+ Sqlite,
+ Avux
}
/// <inheritdoc />
@@ -179,6 +185,9 @@
case ExportType.Sqlite:
await ExportVaultSqlite();
break;
+ case ExportType.Avux:
+ await ExportVaultAvux();
+ break;
}
}
@@ -223,6 +232,66 @@
}
}
+ private async Task ExportVaultAvux()
+ {
+ GlobalLoadingSpinner.Show(Localizer["ExportingVaultMessage"]);
+ try
+ {
+ var context = await DbService.GetDbContextAsync();
+
+ // Load all vault entities with their related data
+ var items = await context.Items
+ .Where(i => !i.IsDeleted && i.DeletedAt == null)
+ .Include(i => i.FieldValues)
+ .Include(i => i.Attachments)
+ .Include(i => i.TotpCodes)
+ .Include(i => i.Passkeys)
+ .ToListAsync();
+
+ var folders = await context.Folders
+ .Where(f => !f.IsDeleted)
+ .ToListAsync();
+
+ var tags = await context.Tags
+ .Where(t => !t.IsDeleted)
+ .ToListAsync();
+
+ var itemTags = await context.ItemTags
+ .Where(it => !it.IsDeleted)
+ .ToListAsync();
+
+ var fieldDefinitions = await context.FieldDefinitions
+ .Where(fd => !fd.IsDeleted)
+ .ToListAsync();
+
+ var username = await GetUsernameAsync();
+
+ // Export to .avux format
+ var zipBytes = await VaultExportService.ExportToAvuxAsync(
+ items,
+ folders,
+ tags,
+ itemTags,
+ fieldDefinitions,
+ username);
+
+ await JsInteropService.DownloadFileFromStream(
+ $"{await GetExportFileName("avux")}",
+ zipBytes);
+ }
+ catch (Exception ex)
+ {
+ Logger.LogError(ex, "Error exporting vault to .avux format");
+ GlobalNotificationService.AddErrorMessage(
+ $"{Localizer["ExportErrorTitle"]}: {Localizer["ExportErrorMessage"]}",
+ true);
+ }
+ finally
+ {
+ GlobalLoadingSpinner.Hide();
+ }
+ }
+
/// <summary>
/// Creates a filename for the export file based on the current date and username.
/// </summary>
diff --git a/apps/server/Utilities/AliasVault.ImportExport/Importers/BaseImporter.cs b/apps/server/Utilities/AliasVault.ImportExport/Importers/BaseImporter.cs
index e83ae17cd..29f5e45a1 100644
--- a/apps/server/Utilities/AliasVault.ImportExport/Importers/BaseImporter.cs
+++ b/apps/server/Utilities/AliasVault.ImportExport/Importers/BaseImporter.cs
@@ -254,6 +254,42 @@ public static class BaseImporter
}
}
+ // Add passkeys if present
+ if (importedCredential.Passkeys != null)
+ {
+ foreach (var passkey in importedCredential.Passkeys)
+ {
+ item.Passkeys.Add(new Passkey
+ {
+ Id = Guid.NewGuid(),
+ RpId = passkey.RpId,
+ UserHandle = passkey.UserHandle ?? Array.Empty<byte>(),
+ PublicKey = passkey.PublicKey,
+ PrivateKey = passkey.PrivateKey,
+ PrfKey = passkey.PrfKey,
+ DisplayName = passkey.DisplayName,
+ CreatedAt = createdAt,
+ UpdatedAt = updatedAt,
+ });
+ }
+ }
+
+ // Add attachments if present
+ if (importedCredential.Attachments != null)
+ {
+ foreach (var attachment in importedCredential.Attachments)
+ {
+ item.Attachments.Add(new Attachment
+ {
+ Id = Guid.NewGuid(),
+ Filename = attachment.Filename,
+ Blob = attachment.Blob,
+ CreatedAt = createdAt,
+ UpdatedAt = updatedAt,
+ });
+ }
+ }
+
items.Add(item);
}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxAttachment.cs b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxAttachment.cs
new file mode 100644
index 000000000..ac084ba06
--- /dev/null
+++ b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxAttachment.cs
@@ -0,0 +1,29 @@
+//-----------------------------------------------------------------------
+// <copyright file="AvuxAttachment.cs" company="aliasvault">
+// Copyright (c) aliasvault. All rights reserved.
+// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace AliasVault.ImportExport.Models.Exports;
+
+/// <summary>
+/// Represents an attachment in an item.
+/// </summary>
+public class AvuxAttachment
+{
+ /// <summary>
+ /// Gets or sets the attachment ID.
+ /// </summary>
+ public Guid Id { get; set; }
+
+ /// <summary>
+ /// Gets or sets the filename.
+ /// </summary>
+ public string Filename { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the relative path in the .avux archive.
+ /// </summary>
+ public string RelativePath { get; set; } = string.Empty;
+}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxFieldDefinition.cs b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxFieldDefinition.cs
new file mode 100644
index 000000000..55f6f86c1
--- /dev/null
+++ b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxFieldDefinition.cs
@@ -0,0 +1,54 @@
+//-----------------------------------------------------------------------
+// <copyright file="AvuxFieldDefinition.cs" company="aliasvault">
+// Copyright (c) aliasvault. All rights reserved.
+// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace AliasVault.ImportExport.Models.Exports;
+
+/// <summary>
+/// Represents a custom field definition.
+/// </summary>
+public class AvuxFieldDefinition
+{
+ /// <summary>
+ /// Gets or sets the field definition ID.
+ /// </summary>
+ public Guid Id { get; set; }
+
+ /// <summary>
+ /// Gets or sets the field type.
+ /// </summary>
+ public string FieldType { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the field label.
+ /// </summary>
+ public string Label { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets a value indicating whether this field supports multiple values.
+ /// </summary>
+ public bool IsMultiValue { get; set; }
+
+ /// <summary>
+ /// Gets or sets a value indicating whether this field is hidden.
+ /// </summary>
+ public bool IsHidden { get; set; }
+
+ /// <summary>
+ /// Gets or sets a value indicating whether history is enabled for this field.
+ /// </summary>
+ public bool EnableHistory { get; set; }
+
+ /// <summary>
+ /// Gets or sets the display order weight.
+ /// </summary>
+ public int Weight { get; set; }
+
+ /// <summary>
+ /// Gets or sets the item types this field applies to (JSON array).
+ /// </summary>
+ public string? ApplicableToTypes { get; set; }
+}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxFieldValue.cs b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxFieldValue.cs
new file mode 100644
index 000000000..816c7e406
--- /dev/null
+++ b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxFieldValue.cs
@@ -0,0 +1,39 @@
+//-----------------------------------------------------------------------
+// <copyright file="AvuxFieldValue.cs" company="aliasvault">
+// Copyright (c) aliasvault. All rights reserved.
+// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace AliasVault.ImportExport.Models.Exports;
+
+/// <summary>
+/// Represents a field value in an item.
+/// </summary>
+public class AvuxFieldValue
+{
+ /// <summary>
+ /// Gets or sets the field value ID.
+ /// </summary>
+ public Guid Id { get; set; }
+
+ /// <summary>
+ /// Gets or sets the field key (e.g., "login.username").
+ /// </summary>
+ public string? FieldKey { get; set; }
+
+ /// <summary>
+ /// Gets or sets the custom field definition ID (if this is a custom field).
+ /// </summary>
+ public Guid? FieldDefinitionId { get; set; }
+
+ /// <summary>
+ /// Gets or sets the field value.
+ /// </summary>
+ public string? Value { get; set; }
+
+ /// <summary>
+ /// Gets or sets the display order weight.
+ /// </summary>
+ public int Weight { get; set; }
+}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxFolder.cs b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxFolder.cs
new file mode 100644
index 000000000..dfc0958d3
--- /dev/null
+++ b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxFolder.cs
@@ -0,0 +1,44 @@
+//-----------------------------------------------------------------------
+// <copyright file="AvuxFolder.cs" company="aliasvault">
+// Copyright (c) aliasvault. All rights reserved.
+// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace AliasVault.ImportExport.Models.Exports;
+
+/// <summary>
+/// Represents a folder.
+/// </summary>
+public class AvuxFolder
+{
+ /// <summary>
+ /// Gets or sets the folder ID.
+ /// </summary>
+ public Guid Id { get; set; }
+
+ /// <summary>
+ /// Gets or sets the folder name.
+ /// </summary>
+ public string Name { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the parent folder ID (null for root folders).
+ /// </summary>
+ public Guid? ParentFolderId { get; set; }
+
+ /// <summary>
+ /// Gets or sets the display order weight.
+ /// </summary>
+ public int Weight { get; set; }
+
+ /// <summary>
+ /// Gets or sets the creation timestamp.
+ /// </summary>
+ public DateTime CreatedAt { get; set; }
+
+ /// <summary>
+ /// Gets or sets the last update timestamp.
+ /// </summary>
+ public DateTime UpdatedAt { get; set; }
+}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxItem.cs b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxItem.cs
new file mode 100644
index 000000000..e26156726
--- /dev/null
+++ b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxItem.cs
@@ -0,0 +1,64 @@
+//-----------------------------------------------------------------------
+// <copyright file="AvuxItem.cs" company="aliasvault">
+// Copyright (c) aliasvault. All rights reserved.
+// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace AliasVault.ImportExport.Models.Exports;
+
+/// <summary>
+/// Represents an item in the .avux export.
+/// </summary>
+public class AvuxItem
+{
+ /// <summary>
+ /// Gets or sets the item ID.
+ /// </summary>
+ public Guid Id { get; set; }
+
+ /// <summary>
+ /// Gets or sets the item name.
+ /// </summary>
+ public string? Name { get; set; }
+
+ /// <summary>
+ /// Gets or sets the item type (Login, Alias, CreditCard, Note).
+ /// </summary>
+ public string ItemType { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the creation timestamp.
+ /// </summary>
+ public DateTime CreatedAt { get; set; }
+
+ /// <summary>
+ /// Gets or sets the last update timestamp.
+ /// </summary>
+ public DateTime UpdatedAt { get; set; }
+
+ /// <summary>
+ /// Gets or sets the folder ID this item belongs to.
+ /// </summary>
+ public Guid? FolderId { get; set; }
+
+ /// <summary>
+ /// Gets or sets the list of field values for this item.
+ /// </summary>
+ public List<AvuxFieldValue> FieldValues { get; set; } = new();
+
+ /// <summary>
+ /// Gets or sets the list of attachments for this item.
+ /// </summary>
+ public List<AvuxAttachment> Attachments { get; set; } = new();
+
+ /// <summary>
+ /// Gets or sets the list of TOTP codes for this item.
+ /// </summary>
+ public List<AvuxTotpCode> TotpCodes { get; set; } = new();
+
+ /// <summary>
+ /// Gets or sets the list of passkeys for this item.
+ /// </summary>
+ public List<AvuxPasskey> Passkeys { get; set; } = new();
+}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxItemTag.cs b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxItemTag.cs
new file mode 100644
index 000000000..5017ca937
--- /dev/null
+++ b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxItemTag.cs
@@ -0,0 +1,29 @@
+//-----------------------------------------------------------------------
+// <copyright file="AvuxItemTag.cs" company="aliasvault">
+// Copyright (c) aliasvault. All rights reserved.
+// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace AliasVault.ImportExport.Models.Exports;
+
+/// <summary>
+/// Represents an item-tag association.
+/// </summary>
+public class AvuxItemTag
+{
+ /// <summary>
+ /// Gets or sets the association ID.
+ /// </summary>
+ public Guid Id { get; set; }
+
+ /// <summary>
+ /// Gets or sets the item ID.
+ /// </summary>
+ public Guid ItemId { get; set; }
+
+ /// <summary>
+ /// Gets or sets the tag ID.
+ /// </summary>
+ public Guid TagId { get; set; }
+}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxManifest.cs b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxManifest.cs
new file mode 100644
index 000000000..3e9b7354f
--- /dev/null
+++ b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxManifest.cs
@@ -0,0 +1,54 @@
+//-----------------------------------------------------------------------
+// <copyright file="AvuxManifest.cs" company="aliasvault">
+// Copyright (c) aliasvault. All rights reserved.
+// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace AliasVault.ImportExport.Models.Exports;
+
+/// <summary>
+/// Represents the complete manifest for an .avux export file.
+/// </summary>
+public class AvuxManifest
+{
+ /// <summary>
+ /// Gets or sets the export format version.
+ /// </summary>
+ public string Version { get; set; } = "1.0.0";
+
+ /// <summary>
+ /// Gets or sets the export timestamp.
+ /// </summary>
+ public DateTime ExportedAt { get; set; }
+
+ /// <summary>
+ /// Gets or sets the username who created the export.
+ /// </summary>
+ public string ExportedBy { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the list of items in the vault.
+ /// </summary>
+ public List<AvuxItem> Items { get; set; } = new();
+
+ /// <summary>
+ /// Gets or sets the list of folders.
+ /// </summary>
+ public List<AvuxFolder> Folders { get; set; } = new();
+
+ /// <summary>
+ /// Gets or sets the list of tags.
+ /// </summary>
+ public List<AvuxTag> Tags { get; set; } = new();
+
+ /// <summary>
+ /// Gets or sets the list of item-tag associations.
+ /// </summary>
+ public List<AvuxItemTag> ItemTags { get; set; } = new();
+
+ /// <summary>
+ /// Gets or sets the list of custom field definitions.
+ /// </summary>
+ public List<AvuxFieldDefinition> FieldDefinitions { get; set; } = new();
+}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxPasskey.cs b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxPasskey.cs
new file mode 100644
index 000000000..194238af5
--- /dev/null
+++ b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxPasskey.cs
@@ -0,0 +1,49 @@
+//-----------------------------------------------------------------------
+// <copyright file="AvuxPasskey.cs" company="aliasvault">
+// Copyright (c) aliasvault. All rights reserved.
+// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace AliasVault.ImportExport.Models.Exports;
+
+/// <summary>
+/// Represents a passkey in an item.
+/// </summary>
+public class AvuxPasskey
+{
+ /// <summary>
+ /// Gets or sets the passkey ID.
+ /// </summary>
+ public Guid Id { get; set; }
+
+ /// <summary>
+ /// Gets or sets the relying party ID.
+ /// </summary>
+ public string RpId { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the user handle (base64-encoded).
+ /// </summary>
+ public string? UserHandle { get; set; }
+
+ /// <summary>
+ /// Gets or sets the public key (JWK format).
+ /// </summary>
+ public string PublicKey { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the private key (JWK format).
+ /// </summary>
+ public string PrivateKey { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the PRF key (base64-encoded).
+ /// </summary>
+ public string? PrfKey { get; set; }
+
+ /// <summary>
+ /// Gets or sets the display name.
+ /// </summary>
+ public string DisplayName { get; set; } = string.Empty;
+}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxTag.cs b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxTag.cs
new file mode 100644
index 000000000..630e2c102
--- /dev/null
+++ b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxTag.cs
@@ -0,0 +1,44 @@
+//-----------------------------------------------------------------------
+// <copyright file="AvuxTag.cs" company="aliasvault">
+// Copyright (c) aliasvault. All rights reserved.
+// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace AliasVault.ImportExport.Models.Exports;
+
+/// <summary>
+/// Represents a tag.
+/// </summary>
+public class AvuxTag
+{
+ /// <summary>
+ /// Gets or sets the tag ID.
+ /// </summary>
+ public Guid Id { get; set; }
+
+ /// <summary>
+ /// Gets or sets the tag name.
+ /// </summary>
+ public string Name { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the tag color.
+ /// </summary>
+ public string? Color { get; set; }
+
+ /// <summary>
+ /// Gets or sets the display order.
+ /// </summary>
+ public int DisplayOrder { get; set; }
+
+ /// <summary>
+ /// Gets or sets the creation timestamp.
+ /// </summary>
+ public DateTime CreatedAt { get; set; }
+
+ /// <summary>
+ /// Gets or sets the last update timestamp.
+ /// </summary>
+ public DateTime UpdatedAt { get; set; }
+}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxTotpCode.cs b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxTotpCode.cs
new file mode 100644
index 000000000..ad319ad44
--- /dev/null
+++ b/apps/server/Utilities/AliasVault.ImportExport/Models/Exports/AvuxTotpCode.cs
@@ -0,0 +1,29 @@
+//-----------------------------------------------------------------------
+// <copyright file="AvuxTotpCode.cs" company="aliasvault">
+// Copyright (c) aliasvault. All rights reserved.
+// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace AliasVault.ImportExport.Models.Exports;
+
+/// <summary>
+/// Represents a TOTP code in an item.
+/// </summary>
+public class AvuxTotpCode
+{
+ /// <summary>
+ /// Gets or sets the TOTP code ID.
+ /// </summary>
+ public Guid Id { get; set; }
+
+ /// <summary>
+ /// Gets or sets the TOTP code name.
+ /// </summary>
+ public string Name { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the TOTP secret key.
+ /// </summary>
+ public string SecretKey { get; set; } = string.Empty;
+}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/Models/ImportedAttachment.cs b/apps/server/Utilities/AliasVault.ImportExport/Models/ImportedAttachment.cs
new file mode 100644
index 000000000..626ac0738
--- /dev/null
+++ b/apps/server/Utilities/AliasVault.ImportExport/Models/ImportedAttachment.cs
@@ -0,0 +1,24 @@
+//-----------------------------------------------------------------------
+// <copyright file="ImportedAttachment.cs" company="aliasvault">
+// Copyright (c) aliasvault. All rights reserved.
+// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace AliasVault.ImportExport.Models;
+
+/// <summary>
+/// Represents an attachment in an intermediary format that is imported from various sources.
+/// </summary>
+public class ImportedAttachment
+{
+ /// <summary>
+ /// Gets or sets the filename.
+ /// </summary>
+ public string Filename { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the file blob data.
+ /// </summary>
+ public byte[] Blob { get; set; } = Array.Empty<byte>();
+}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/Models/ImportedCredential.cs b/apps/server/Utilities/AliasVault.ImportExport/Models/ImportedCredential.cs
index 34d20ba1f..055859cea 100644
--- a/apps/server/Utilities/AliasVault.ImportExport/Models/ImportedCredential.cs
+++ b/apps/server/Utilities/AliasVault.ImportExport/Models/ImportedCredential.cs
@@ -86,4 +86,25 @@ public class ImportedCredential
/// Each importer should populate this from its own format.
/// </summary>
public ImportedCreditcard? Creditcard { get; set; }
+
+ /// <summary>
+ /// Gets or sets the list of passkeys associated with this credential.
+ /// </summary>
+ public List<ImportedPasskey>? Passkeys { get; set; }
+
+ /// <summary>
+ /// Gets or sets the list of tags associated with this credential.
+ /// </summary>
+ public List<string>? Tags { get; set; }
+
+ /// <summary>
+ /// Gets or sets the list of attachments associated with this credential.
+ /// </summary>
+ public List<ImportedAttachment>? Attachments { get; set; }
+
+ /// <summary>
+ /// Gets or sets custom field definitions for this credential.
+ /// Key is the field label, value is the field value.
+ /// </summary>
+ public Dictionary<string, string>? CustomFields { get; set; }
}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/Models/ImportedPasskey.cs b/apps/server/Utilities/AliasVault.ImportExport/Models/ImportedPasskey.cs
new file mode 100644
index 000000000..1ce193819
--- /dev/null
+++ b/apps/server/Utilities/AliasVault.ImportExport/Models/ImportedPasskey.cs
@@ -0,0 +1,44 @@
+//-----------------------------------------------------------------------
+// <copyright file="ImportedPasskey.cs" company="aliasvault">
+// Copyright (c) aliasvault. All rights reserved.
+// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace AliasVault.ImportExport.Models;
+
+/// <summary>
+/// Represents a passkey in an intermediary format that is imported from various sources.
+/// </summary>
+public class ImportedPasskey
+{
+ /// <summary>
+ /// Gets or sets the relying party ID.
+ /// </summary>
+ public string RpId { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the user handle (user ID provided by relying party).
+ /// </summary>
+ public byte[]? UserHandle { get; set; }
+
+ /// <summary>
+ /// Gets or sets the public key (JWK format).
+ /// </summary>
+ public string PublicKey { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the private key (JWK format).
+ /// </summary>
+ public string PrivateKey { get; set; } = string.Empty;
+
+ /// <summary>
+ /// Gets or sets the PRF key (optional).
+ /// </summary>
+ public byte[]? PrfKey { get; set; }
+
+ /// <summary>
+ /// Gets or sets the display name for the passkey.
+ /// </summary>
+ public string DisplayName { get; set; } = string.Empty;
+}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/VaultExportService.cs b/apps/server/Utilities/AliasVault.ImportExport/VaultExportService.cs
new file mode 100644
index 000000000..7fc4278a4
--- /dev/null
+++ b/apps/server/Utilities/AliasVault.ImportExport/VaultExportService.cs
@@ -0,0 +1,279 @@
+//-----------------------------------------------------------------------
+// <copyright file="VaultExportService.cs" company="aliasvault">
+// Copyright (c) aliasvault. All rights reserved.
+// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace AliasVault.ImportExport;
+
+using System.IO.Compression;
+using System.Text;
+using System.Text.Json;
+using AliasClientDb;
+using AliasVault.ImportExport.Models.Exports;
+
+/// <summary>
+/// Service for exporting vault data to .avux format.
+/// </summary>
+public static class VaultExportService
+{
+ /// <summary>
+ /// Exports vault data to .avux (AliasVault Unencrypted eXport) format.
+ /// This creates a ZIP archive containing a manifest.json file and all attachments.
+ /// </summary>
+ /// <param name="items">The items to export.</param>
+ /// <param name="folders">The folders to export.</param>
+ /// <param name="tags">The tags to export.</param>
+ /// <param name="itemTags">The item-tag associations to export.</param>
+ /// <param name="fieldDefinitions">The custom field definitions to export.</param>
+ /// <param name="username">The username creating the export.</param>
+ /// <returns>A byte array containing the .avux ZIP file.</returns>
+ public static async Task<byte[]> ExportToAvuxAsync(
+ List<Item> items,
+ List<Folder> folders,
+ List<Tag> tags,
+ List<ItemTag> itemTags,
+ List<FieldDefinition> fieldDefinitions,
+ string username)
+ {
+ var manifest = CreateManifest(items, folders, tags, itemTags, fieldDefinitions, username);
+ var attachmentMap = ExtractAttachments(items);
+
+ return await PackageAsZipAsync(manifest, attachmentMap);
+ }
+
+ /// <summary>
+ /// Creates the manifest object from vault entities.
+ /// </summary>
+ private static AvuxManifest CreateManifest(
+ List<Item> items,
+ List<Folder> folders,
+ List<Tag> tags,
+ List<ItemTag> itemTags,
+ List<FieldDefinition> fieldDefinitions,
+ string username)
+ {
+ var manifest = new AvuxManifest
+ {
+ Version = "1.0.0",
+ ExportedAt = DateTime.UtcNow,
+ ExportedBy = username,
+ Items = items.Where(i => !i.IsDeleted).Select(MapItemToAvux).ToList(),
+ Folders = folders.Where(f => !f.IsDeleted).Select(MapFolderToAvux).ToList(),
+ Tags = tags.Where(t => !t.IsDeleted).Select(MapTagToAvux).ToList(),
+ ItemTags = itemTags.Where(it => !it.IsDeleted).Select(MapItemTagToAvux).ToList(),
+ FieldDefinitions = fieldDefinitions.Where(fd => !fd.IsDeleted).Select(MapFieldDefinitionToAvux).ToList(),
+ };
+
+ return manifest;
+ }
+
+ /// <summary>
+ /// Maps an Item entity to AvuxItem.
+ /// </summary>
+ private static AvuxItem MapItemToAvux(Item item)
+ {
+ return new AvuxItem
+ {
+ Id = item.Id,
+ Name = item.Name,
+ ItemType = item.ItemType,
+ CreatedAt = item.CreatedAt,
+ UpdatedAt = item.UpdatedAt,
+ FolderId = item.FolderId,
+ FieldValues = item.FieldValues
+ .Where(fv => !fv.IsDeleted)
+ .Select(MapFieldValueToAvux)
+ .ToList(),
+ Attachments = item.Attachments
+ .Where(a => !a.IsDeleted)
+ .Select(MapAttachmentToAvux)
+ .ToList(),
+ TotpCodes = item.TotpCodes
+ .Where(tc => !tc.IsDeleted)
+ .Select(MapTotpCodeToAvux)
+ .ToList(),
+ Passkeys = item.Passkeys
+ .Where(p => !p.IsDeleted)
+ .Select(MapPasskeyToAvux)
+ .ToList(),
+ };
+ }
+
+ /// <summary>
+ /// Maps a FieldValue entity to AvuxFieldValue.
+ /// </summary>
+ private static AvuxFieldValue MapFieldValueToAvux(FieldValue fieldValue)
+ {
+ return new AvuxFieldValue
+ {
+ Id = fieldValue.Id,
+ FieldKey = fieldValue.FieldKey,
+ FieldDefinitionId = fieldValue.FieldDefinitionId,
+ Value = fieldValue.Value,
+ Weight = fieldValue.Weight,
+ };
+ }
+
+ /// <summary>
+ /// Maps an Attachment entity to AvuxAttachment.
+ /// </summary>
+ private static AvuxAttachment MapAttachmentToAvux(Attachment attachment)
+ {
+ var relativePath = $"attachments/{attachment.ItemId}_{attachment.Id}_{attachment.Filename}";
+ return new AvuxAttachment
+ {
+ Id = attachment.Id,
+ Filename = attachment.Filename,
+ RelativePath = relativePath,
+ };
+ }
+
+ /// <summary>
+ /// Maps a TotpCode entity to AvuxTotpCode.
+ /// </summary>
+ private static AvuxTotpCode MapTotpCodeToAvux(TotpCode totpCode)
+ {
+ return new AvuxTotpCode
+ {
+ Id = totpCode.Id,
+ Name = totpCode.Name,
+ SecretKey = totpCode.SecretKey,
+ };
+ }
+
+ /// <summary>
+ /// Maps a Passkey entity to AvuxPasskey.
+ /// </summary>
+ private static AvuxPasskey MapPasskeyToAvux(Passkey passkey)
+ {
+ return new AvuxPasskey
+ {
+ Id = passkey.Id,
+ RpId = passkey.RpId,
+ UserHandle = passkey.UserHandle != null ? Convert.ToBase64String(passkey.UserHandle) : null,
+ PublicKey = passkey.PublicKey,
+ PrivateKey = passkey.PrivateKey,
+ PrfKey = passkey.PrfKey != null ? Convert.ToBase64String(passkey.PrfKey) : null,
+ DisplayName = passkey.DisplayName,
+ };
+ }
+
+ /// <summary>
+ /// Maps a Folder entity to AvuxFolder.
+ /// </summary>
+ private static AvuxFolder MapFolderToAvux(Folder folder)
+ {
+ return new AvuxFolder
+ {
+ Id = folder.Id,
+ Name = folder.Name,
+ ParentFolderId = folder.ParentFolderId,
+ Weight = folder.Weight,
+ CreatedAt = folder.CreatedAt,
+ UpdatedAt = folder.UpdatedAt,
+ };
+ }
+
+ /// <summary>
+ /// Maps a Tag entity to AvuxTag.
+ /// </summary>
+ private static AvuxTag MapTagToAvux(Tag tag)
+ {
+ return new AvuxTag
+ {
+ Id = tag.Id,
+ Name = tag.Name,
+ Color = tag.Color,
+ DisplayOrder = tag.DisplayOrder,
+ CreatedAt = tag.CreatedAt,
+ UpdatedAt = tag.UpdatedAt,
+ };
+ }
+
+ /// <summary>
+ /// Maps an ItemTag entity to AvuxItemTag.
+ /// </summary>
+ private static AvuxItemTag MapItemTagToAvux(ItemTag itemTag)
+ {
+ return new AvuxItemTag
+ {
+ Id = itemTag.Id,
+ ItemId = itemTag.ItemId,
+ TagId = itemTag.TagId,
+ };
+ }
+
+ /// <summary>
+ /// Maps a FieldDefinition entity to AvuxFieldDefinition.
+ /// </summary>
+ private static AvuxFieldDefinition MapFieldDefinitionToAvux(FieldDefinition fieldDefinition)
+ {
+ return new AvuxFieldDefinition
+ {
+ Id = fieldDefinition.Id,
+ FieldType = fieldDefinition.FieldType,
+ Label = fieldDefinition.Label,
+ IsMultiValue = fieldDefinition.IsMultiValue,
+ IsHidden = fieldDefinition.IsHidden,
+ EnableHistory = fieldDefinition.EnableHistory,
+ Weight = fieldDefinition.Weight,
+ ApplicableToTypes = fieldDefinition.ApplicableToTypes,
+ };
+ }
+
+ /// <summary>
+ /// Extracts attachments from items and creates a mapping of relative paths to blob data.
+ /// </summary>
+ private static Dictionary<string, byte[]> ExtractAttachments(List<Item> items)
+ {
+ var attachmentMap = new Dictionary<string, byte[]>();
+
+ foreach (var item in items.Where(i => !i.IsDeleted))
+ {
+ foreach (var attachment in item.Attachments.Where(a => !a.IsDeleted))
+ {
+ var relativePath = $"attachments/{item.Id}_{attachment.Id}_{attachment.Filename}";
+ attachmentMap[relativePath] = attachment.Blob;
+ }
+ }
+
+ return attachmentMap;
+ }
+
+ /// <summary>
+ /// Packages the manifest and attachments into a ZIP archive.
+ /// </summary>
+ private static async Task<byte[]> PackageAsZipAsync(AvuxManifest manifest, Dictionary<string, byte[]> attachments)
+ {
+ using var memoryStream = new MemoryStream();
+ using (var archive = new ZipArchive(memoryStream, ZipArchiveMode.Create, true))
+ {
+ // Add manifest.json
+ var manifestEntry = archive.CreateEntry("manifest.json");
+ using (var entryStream = manifestEntry.Open())
+ {
+ var jsonOptions = new JsonSerializerOptions
+ {
+ WriteIndented = true,
+ PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
+ };
+
+ var json = JsonSerializer.Serialize(manifest, jsonOptions);
+ var bytes = Encoding.UTF8.GetBytes(json);
+ await entryStream.WriteAsync(bytes);
+ }
+
+ // Add attachments
+ foreach (var (path, data) in attachments)
+ {
+ var attachmentEntry = archive.CreateEntry(path);
+ using var entryStream = attachmentEntry.Open();
+ await entryStream.WriteAsync(data);
+ }
+ }
+
+ return memoryStream.ToArray();
+ }
+}
diff --git a/apps/server/Utilities/AliasVault.ImportExport/VaultImportService.cs b/apps/server/Utilities/AliasVault.ImportExport/VaultImportService.cs
new file mode 100644
index 000000000..eef9f1b76
--- /dev/null
+++ b/apps/server/Utilities/AliasVault.ImportExport/VaultImportService.cs
@@ -0,0 +1,281 @@
+//-----------------------------------------------------------------------
+// <copyright file="VaultImportService.cs" company="aliasvault">
+// Copyright (c) aliasvault. All rights reserved.
+// Licensed under the AGPLv3 license. See LICENSE.md file in the project root for full license information.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace AliasVault.ImportExport;
+
+using System.IO.Compression;
+using System.Text.Json;
+using AliasVault.ImportExport.Models;
+using AliasVault.ImportExport.Models.Exports;
+
+/// <summary>
+/// Service for importing vault data from .avux format.
+/// </summary>
+public static class VaultImportService
+{
+ /// <summary>
+ /// Imports vault data from .avux (AliasVault Unencrypted eXport) format.
+ /// This parses a ZIP archive containing a manifest.json file and all attachments.
+ /// </summary>
+ /// <param name="zipBytes">The .avux file as a byte array.</param>
+ /// <returns>A list of imported credentials.</returns>
+ public static async Task<List<ImportedCredential>> ImportFromAvuxAsync(byte[] zipBytes)
+ {
+ using var zipStream = new MemoryStream(zipBytes);
+ using var archive = new ZipArchive(zipStream, ZipArchiveMode.Read);
+
+ // Extract manifest.json
+ var manifestEntry = archive.GetEntry("manifest.json");
+ if (manifestEntry == null)
+ {
+ throw new InvalidOperationException("Invalid .avux file: manifest.json not found");
+ }
+
+ string manifestJson;
+ using (var reader = new StreamReader(manifestEntry.Open()))
+ {
+ manifestJson = await reader.ReadToEndAsync();
+ }
+
+ var jsonOptions = new JsonSerializerOptions
+ {
+ PropertyNameCaseInsensitive = true,
+ };
+
+ var manifest = JsonSerializer.Deserialize<AvuxManifest>(manifestJson, jsonOptions);
+ if (manifest == null)
+ {
+ throw new InvalidOperationException("Failed to parse manifest.json");
+ }
+
+ // Validate version
+ if (manifest.Version != "1.0.0")
+ {
+ throw new InvalidOperationException($"Unsupported .avux version: {manifest.Version}. Expected 1.0.0.");
+ }
+
+ // Extract attachments
+ var attachmentMap = ExtractAttachmentsFromZip(archive);
+
+ // Convert to ImportedCredential format
+ return ConvertManifestToImportedCredentials(manifest, attachmentMap);
+ }
+
+ /// <summary>
+ /// Extracts all attachments from the ZIP archive.
+ /// </summary>
+ private static Dictionary<string, byte[]> ExtractAttachmentsFromZip(ZipArchive archive)
+ {
+ var map = new Dictionary<string, byte[]>();
+
+ foreach (var entry in archive.Entries)
+ {
+ if (entry.FullName.StartsWith("attachments/"))
+ {
+ using var stream = entry.Open();
+ using var ms = new MemoryStream();
+ stream.CopyTo(ms);
+ map[entry.FullName] = ms.ToArray();
+ }
+ }
+
+ return map;
+ }
+
+ /// <summary>
+ /// Converts the manifest and attachments to ImportedCredential objects.
+ /// This maintains compatibility with the existing import flow.
+ /// </summary>
+ private static List<ImportedCredential> ConvertManifestToImportedCredentials(
+ AvuxManifest manifest,
+ Dictionary<string, byte[]> attachmentMap)
+ {
+ var credentials = new List<ImportedCredential>();
+ var folderMap = manifest.Folders.ToDictionary(f => f.Id, f => f.Name);
+
+ foreach (var item in manifest.Items)
+ {
+ var credential = new ImportedCredential
+ {
+ ServiceName = item.Name,
+ CreatedAt = item.CreatedAt,
+ UpdatedAt = item.UpdatedAt,
+ ItemType = MapItemType(item.ItemType),
+ };
+
+ // Get folder path
+ if (item.FolderId.HasValue && folderMap.TryGetValue(item.FolderId.Value, out var folderName))
+ {
+ credential.FolderPath = folderName;
+ }
+
+ // Extract field values
+ ExtractFieldValues(credential, item.FieldValues);
+
+ // Add TOTP codes
+ if (item.TotpCodes.Count > 0)
+ {
+ // For now, we only support one TOTP per item in the import format
+ credential.TwoFactorSecret = item.TotpCodes.First().SecretKey;
+ }
+
+ // Add passkeys
+ if (item.Passkeys.Count > 0)
+ {
+ credential.Passkeys = item.Passkeys.Select(MapAvuxPasskeyToImported).ToList();
+ }
+
+ // Add attachments
+ if (item.Attachments.Count > 0)
+ {
+ credential.Attachments = item.Attachments.Select(a => MapAvuxAttachmentToImported(a, attachmentMap)).ToList();
+ }
+
+ credentials.Add(credential);
+ }
+
+ return credentials;
+ }
+
+ /// <summary>
+ /// Extracts field values from the AvuxItem and populates the ImportedCredential.
+ /// </summary>
+ private static void ExtractFieldValues(ImportedCredential credential, List<AvuxFieldValue> fieldValues)
+ {
+ foreach (var fieldValue in fieldValues)
+ {
+ if (string.IsNullOrEmpty(fieldValue.FieldKey))
+ {
+ // Custom field - will be handled separately
+ continue;
+ }
+
+ // Map system fields to ImportedCredential properties
+ switch (fieldValue.FieldKey)
+ {
+ case "login.username":
+ credential.Username = fieldValue.Value;
+ break;
+ case "login.password":
+ credential.Password = fieldValue.Value;
+ break;
+ case "login.email":
+ credential.Email = fieldValue.Value;
+ break;
+ case "login.url":
+ credential.ServiceUrls ??= new List<string>();
+ if (!string.IsNullOrEmpty(fieldValue.Value))
+ {
+ credential.ServiceUrls.Add(fieldValue.Value);
+ }
+
+ break;
+ case "notes.content":
+ credential.Notes = fieldValue.Value;
+ break;
+ case "alias.first_name":
+ credential.Alias ??= new ImportedAlias();
+ credential.Alias.FirstName = fieldValue.Value;
+ break;
+ case "alias.last_name":
+ credential.Alias ??= new ImportedAlias();
+ credential.Alias.LastName = fieldValue.Value;
+ break;
+ case "alias.gender":
+ credential.Alias ??= new ImportedAlias();
+ credential.Alias.Gender = fieldValue.Value;
+ break;
+ case "alias.birthdate":
+ credential.Alias ??= new ImportedAlias();
+ if (DateTime.TryParse(fieldValue.Value, out var birthdate))
+ {
+ credential.Alias.BirthDate = birthdate;
+ }
+
+ break;
+ case "card.number":
+ credential.Creditcard ??= new ImportedCreditcard();
+ credential.Creditcard.Number = fieldValue.Value;
+ break;
+ case "card.cardholder_name":
+ credential.Creditcard ??= new ImportedCreditcard();
+ credential.Creditcard.CardholderName = fieldValue.Value;
+ break;
+ case "card.expiry_month":
+ credential.Creditcard ??= new ImportedCreditcard();
+ credential.Creditcard.ExpiryMonth = fieldValue.Value;
+ break;
+ case "card.expiry_year":
+ credential.Creditcard ??= new ImportedCreditcard();
+ credential.Creditcard.ExpiryYear = fieldValue.Value;
+ break;
+ case "card.cvv":
+ credential.Creditcard ??= new ImportedCreditcard();
+ credential.Creditcard.Cvv = fieldValue.Value;
+ break;
+ case "card.pin":
+ credential.Creditcard ??= new ImportedCreditcard();
+ credential.Creditcard.Pin = fieldValue.Value;
+ break;
+ }
+ }
+ }
+
+ /// <summary>
+ /// Maps an item type string to ImportedItemType enum.
+ /// </summary>
+ private static ImportedItemType? MapItemType(string itemType)
+ {
+ return itemType switch
+ {
+ "Login" => ImportedItemType.Login,
+ "Alias" => ImportedItemType.Alias,
+ "CreditCard" => ImportedItemType.Creditcard,
+ "Note" => ImportedItemType.Note,
+ _ => ImportedItemType.Login,
+ };
+ }
+
+ /// <summary>
+ /// Maps an AvuxPasskey to ImportedPasskey.
+ /// </summary>
+ private static ImportedPasskey MapAvuxPasskeyToImported(AvuxPasskey avuxPasskey)
+ {
+ return new ImportedPasskey
+ {
+ RpId = avuxPasskey.RpId,
+ UserHandle = !string.IsNullOrEmpty(avuxPasskey.UserHandle)
+ ? Convert.FromBase64String(avuxPasskey.UserHandle)
+ : null,
+ PublicKey = avuxPasskey.PublicKey,
+ PrivateKey = avuxPasskey.PrivateKey,
+ PrfKey = !string.IsNullOrEmpty(avuxPasskey.PrfKey)
+ ? Convert.FromBase64String(avuxPasskey.PrfKey)
+ : null,
+ DisplayName = avuxPasskey.DisplayName,
+ };
+ }
+
+ /// <summary>
+ /// Maps an AvuxAttachment to ImportedAttachment.
+ /// </summary>
+ private static ImportedAttachment MapAvuxAttachmentToImported(
+ AvuxAttachment avuxAttachment,
+ Dictionary<string, byte[]> attachmentMap)
+ {
+ // Get the blob data from the attachment map
+ var blob = attachmentMap.TryGetValue(avuxAttachment.RelativePath, out var data)
+ ? data
+ : Array.Empty<byte>();
+
+ return new ImportedAttachment
+ {
+ Filename = avuxAttachment.Filename,
+ Blob = blob,
+ };
+ }
+}