Skip to content

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

Update VersionCompatibility tests (#1313)

Leendert de Borste5a15b2486a9
diff --git a/apps/browser-extension/src/utils/dist/shared/vault-sql/index.d.mts b/apps/browser-extension/src/utils/dist/shared/vault-sql/index.d.mts
index bb4891590..d6fc6258b 100644
--- a/apps/browser-extension/src/utils/dist/shared/vault-sql/index.d.mts
+++ b/apps/browser-extension/src/utils/dist/shared/vault-sql/index.d.mts
@@ -181,9 +181,16 @@ type VersionCompatibilityResult = {
* while still preventing incompatibilities from major version changes.
*
* @param databaseVersion - The version string from the database migration (e.g., "1.6.1")
+ * @param clientVersionToCompare - Optional client version to compare against (for testing). If not provided, uses the latest version from VAULT_VERSIONS.
* @returns VersionCompatibilityResult with compatibility information
*/
-declare function checkVersionCompatibility(databaseVersion: string): VersionCompatibilityResult;
+declare function checkVersionCompatibility(databaseVersion: string, clientVersionToCompare?: string): VersionCompatibilityResult;
+/**
+ * Get the latest client version from VAULT_VERSIONS.
+ *
+ * @returns The latest VaultVersion
+ */
+declare function getLatestClientVersion(): VaultVersion;
/**
* Extract version from a migration ID.
*
@@ -195,4 +202,4 @@ declare function checkVersionCompatibility(databaseVersion: string): VersionComp
*/
declare function extractVersionFromMigrationId(migrationId: string): string | null;
-export { COMPLETE_SCHEMA_SQL, CreateVaultSqlGenerator, MIGRATION_SCRIPTS, type SqlGenerationResult, VAULT_VERSIONS, VaultSqlGenerator, type VaultVersion, type VaultVersionInfo, type VersionCompatibilityResult, checkVersionCompatibility, extractVersionFromMigrationId };
+export { COMPLETE_SCHEMA_SQL, CreateVaultSqlGenerator, MIGRATION_SCRIPTS, type SqlGenerationResult, VAULT_VERSIONS, VaultSqlGenerator, type VaultVersion, type VaultVersionInfo, type VersionCompatibilityResult, checkVersionCompatibility, extractVersionFromMigrationId, getLatestClientVersion };
diff --git a/apps/browser-extension/src/utils/dist/shared/vault-sql/index.d.ts b/apps/browser-extension/src/utils/dist/shared/vault-sql/index.d.ts
index bb4891590..d6fc6258b 100644
--- a/apps/browser-extension/src/utils/dist/shared/vault-sql/index.d.ts
+++ b/apps/browser-extension/src/utils/dist/shared/vault-sql/index.d.ts
@@ -181,9 +181,16 @@ type VersionCompatibilityResult = {
* while still preventing incompatibilities from major version changes.
*
* @param databaseVersion - The version string from the database migration (e.g., "1.6.1")
+ * @param clientVersionToCompare - Optional client version to compare against (for testing). If not provided, uses the latest version from VAULT_VERSIONS.
* @returns VersionCompatibilityResult with compatibility information
*/
-declare function checkVersionCompatibility(databaseVersion: string): VersionCompatibilityResult;
+declare function checkVersionCompatibility(databaseVersion: string, clientVersionToCompare?: string): VersionCompatibilityResult;
+/**
+ * Get the latest client version from VAULT_VERSIONS.
+ *
+ * @returns The latest VaultVersion
+ */
+declare function getLatestClientVersion(): VaultVersion;
/**
* Extract version from a migration ID.
*
@@ -195,4 +202,4 @@ declare function checkVersionCompatibility(databaseVersion: string): VersionComp
*/
declare function extractVersionFromMigrationId(migrationId: string): string | null;
-export { COMPLETE_SCHEMA_SQL, CreateVaultSqlGenerator, MIGRATION_SCRIPTS, type SqlGenerationResult, VAULT_VERSIONS, VaultSqlGenerator, type VaultVersion, type VaultVersionInfo, type VersionCompatibilityResult, checkVersionCompatibility, extractVersionFromMigrationId };
+export { COMPLETE_SCHEMA_SQL, CreateVaultSqlGenerator, MIGRATION_SCRIPTS, type SqlGenerationResult, VAULT_VERSIONS, VaultSqlGenerator, type VaultVersion, type VaultVersionInfo, type VersionCompatibilityResult, checkVersionCompatibility, extractVersionFromMigrationId, getLatestClientVersion };
diff --git a/apps/browser-extension/src/utils/dist/shared/vault-sql/index.js b/apps/browser-extension/src/utils/dist/shared/vault-sql/index.js
index d70e2ee3b..0cc31d617 100644
--- a/apps/browser-extension/src/utils/dist/shared/vault-sql/index.js
+++ b/apps/browser-extension/src/utils/dist/shared/vault-sql/index.js
@@ -29,7 +29,8 @@ __export(index_exports, {
VAULT_VERSIONS: () => VAULT_VERSIONS,
VaultSqlGenerator: () => VaultSqlGenerator,
checkVersionCompatibility: () => checkVersionCompatibility,
- extractVersionFromMigrationId: () => extractVersionFromMigrationId
+ extractVersionFromMigrationId: () => extractVersionFromMigrationId,
+ getLatestClientVersion: () => getLatestClientVersion
});
module.exports = __toCommonJS(index_exports);
@@ -1599,7 +1600,7 @@ function parseSemanticVersion(version) {
patch: parseInt(match[3], 10)
};
}
-function checkVersionCompatibility(databaseVersion) {
+function checkVersionCompatibility(databaseVersion, clientVersionToCompare) {
const dbVersion = parseSemanticVersion(databaseVersion);
if (!dbVersion) {
return {
@@ -1621,7 +1622,7 @@ function checkVersionCompatibility(databaseVersion) {
isMinorVersionDifference: false
};
}
- const latestClientVersion = VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+ const latestClientVersion = clientVersionToCompare ? VAULT_VERSIONS.find((v) => v.version === clientVersionToCompare) ?? getLatestClientVersion() : getLatestClientVersion();
const clientVersion = parseSemanticVersion(latestClientVersion.version);
if (!clientVersion) {
return {
@@ -1644,6 +1645,9 @@ function checkVersionCompatibility(databaseVersion) {
isMinorVersionDifference
};
}
+function getLatestClientVersion() {
+ return VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+}
function extractVersionFromMigrationId(migrationId) {
const versionRegex = /_(\d+\.\d+\.\d+)-/;
const versionMatch = versionRegex.exec(migrationId);
@@ -1657,5 +1661,6 @@ function extractVersionFromMigrationId(migrationId) {
VAULT_VERSIONS,
VaultSqlGenerator,
checkVersionCompatibility,
- extractVersionFromMigrationId
+ extractVersionFromMigrationId,
+ getLatestClientVersion
});
diff --git a/apps/browser-extension/src/utils/dist/shared/vault-sql/index.mjs b/apps/browser-extension/src/utils/dist/shared/vault-sql/index.mjs
index 8418edbf1..cf91a9827 100644
--- a/apps/browser-extension/src/utils/dist/shared/vault-sql/index.mjs
+++ b/apps/browser-extension/src/utils/dist/shared/vault-sql/index.mjs
@@ -1568,7 +1568,7 @@ function parseSemanticVersion(version) {
patch: parseInt(match[3], 10)
};
}
-function checkVersionCompatibility(databaseVersion) {
+function checkVersionCompatibility(databaseVersion, clientVersionToCompare) {
const dbVersion = parseSemanticVersion(databaseVersion);
if (!dbVersion) {
return {
@@ -1590,7 +1590,7 @@ function checkVersionCompatibility(databaseVersion) {
isMinorVersionDifference: false
};
}
- const latestClientVersion = VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+ const latestClientVersion = clientVersionToCompare ? VAULT_VERSIONS.find((v) => v.version === clientVersionToCompare) ?? getLatestClientVersion() : getLatestClientVersion();
const clientVersion = parseSemanticVersion(latestClientVersion.version);
if (!clientVersion) {
return {
@@ -1613,6 +1613,9 @@ function checkVersionCompatibility(databaseVersion) {
isMinorVersionDifference
};
}
+function getLatestClientVersion() {
+ return VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+}
function extractVersionFromMigrationId(migrationId) {
const versionRegex = /_(\d+\.\d+\.\d+)-/;
const versionMatch = versionRegex.exec(migrationId);
@@ -1625,5 +1628,6 @@ export {
VAULT_VERSIONS,
VaultSqlGenerator,
checkVersionCompatibility,
- extractVersionFromMigrationId
+ extractVersionFromMigrationId,
+ getLatestClientVersion
};
diff --git a/apps/mobile-app/utils/dist/shared/vault-sql/index.d.mts b/apps/mobile-app/utils/dist/shared/vault-sql/index.d.mts
index bb4891590..d6fc6258b 100644
--- a/apps/mobile-app/utils/dist/shared/vault-sql/index.d.mts
+++ b/apps/mobile-app/utils/dist/shared/vault-sql/index.d.mts
@@ -181,9 +181,16 @@ type VersionCompatibilityResult = {
* while still preventing incompatibilities from major version changes.
*
* @param databaseVersion - The version string from the database migration (e.g., "1.6.1")
+ * @param clientVersionToCompare - Optional client version to compare against (for testing). If not provided, uses the latest version from VAULT_VERSIONS.
* @returns VersionCompatibilityResult with compatibility information
*/
-declare function checkVersionCompatibility(databaseVersion: string): VersionCompatibilityResult;
+declare function checkVersionCompatibility(databaseVersion: string, clientVersionToCompare?: string): VersionCompatibilityResult;
+/**
+ * Get the latest client version from VAULT_VERSIONS.
+ *
+ * @returns The latest VaultVersion
+ */
+declare function getLatestClientVersion(): VaultVersion;
/**
* Extract version from a migration ID.
*
@@ -195,4 +202,4 @@ declare function checkVersionCompatibility(databaseVersion: string): VersionComp
*/
declare function extractVersionFromMigrationId(migrationId: string): string | null;
-export { COMPLETE_SCHEMA_SQL, CreateVaultSqlGenerator, MIGRATION_SCRIPTS, type SqlGenerationResult, VAULT_VERSIONS, VaultSqlGenerator, type VaultVersion, type VaultVersionInfo, type VersionCompatibilityResult, checkVersionCompatibility, extractVersionFromMigrationId };
+export { COMPLETE_SCHEMA_SQL, CreateVaultSqlGenerator, MIGRATION_SCRIPTS, type SqlGenerationResult, VAULT_VERSIONS, VaultSqlGenerator, type VaultVersion, type VaultVersionInfo, type VersionCompatibilityResult, checkVersionCompatibility, extractVersionFromMigrationId, getLatestClientVersion };
diff --git a/apps/mobile-app/utils/dist/shared/vault-sql/index.d.ts b/apps/mobile-app/utils/dist/shared/vault-sql/index.d.ts
index bb4891590..d6fc6258b 100644
--- a/apps/mobile-app/utils/dist/shared/vault-sql/index.d.ts
+++ b/apps/mobile-app/utils/dist/shared/vault-sql/index.d.ts
@@ -181,9 +181,16 @@ type VersionCompatibilityResult = {
* while still preventing incompatibilities from major version changes.
*
* @param databaseVersion - The version string from the database migration (e.g., "1.6.1")
+ * @param clientVersionToCompare - Optional client version to compare against (for testing). If not provided, uses the latest version from VAULT_VERSIONS.
* @returns VersionCompatibilityResult with compatibility information
*/
-declare function checkVersionCompatibility(databaseVersion: string): VersionCompatibilityResult;
+declare function checkVersionCompatibility(databaseVersion: string, clientVersionToCompare?: string): VersionCompatibilityResult;
+/**
+ * Get the latest client version from VAULT_VERSIONS.
+ *
+ * @returns The latest VaultVersion
+ */
+declare function getLatestClientVersion(): VaultVersion;
/**
* Extract version from a migration ID.
*
@@ -195,4 +202,4 @@ declare function checkVersionCompatibility(databaseVersion: string): VersionComp
*/
declare function extractVersionFromMigrationId(migrationId: string): string | null;
-export { COMPLETE_SCHEMA_SQL, CreateVaultSqlGenerator, MIGRATION_SCRIPTS, type SqlGenerationResult, VAULT_VERSIONS, VaultSqlGenerator, type VaultVersion, type VaultVersionInfo, type VersionCompatibilityResult, checkVersionCompatibility, extractVersionFromMigrationId };
+export { COMPLETE_SCHEMA_SQL, CreateVaultSqlGenerator, MIGRATION_SCRIPTS, type SqlGenerationResult, VAULT_VERSIONS, VaultSqlGenerator, type VaultVersion, type VaultVersionInfo, type VersionCompatibilityResult, checkVersionCompatibility, extractVersionFromMigrationId, getLatestClientVersion };
diff --git a/apps/mobile-app/utils/dist/shared/vault-sql/index.js b/apps/mobile-app/utils/dist/shared/vault-sql/index.js
index d70e2ee3b..0cc31d617 100644
--- a/apps/mobile-app/utils/dist/shared/vault-sql/index.js
+++ b/apps/mobile-app/utils/dist/shared/vault-sql/index.js
@@ -29,7 +29,8 @@ __export(index_exports, {
VAULT_VERSIONS: () => VAULT_VERSIONS,
VaultSqlGenerator: () => VaultSqlGenerator,
checkVersionCompatibility: () => checkVersionCompatibility,
- extractVersionFromMigrationId: () => extractVersionFromMigrationId
+ extractVersionFromMigrationId: () => extractVersionFromMigrationId,
+ getLatestClientVersion: () => getLatestClientVersion
});
module.exports = __toCommonJS(index_exports);
@@ -1599,7 +1600,7 @@ function parseSemanticVersion(version) {
patch: parseInt(match[3], 10)
};
}
-function checkVersionCompatibility(databaseVersion) {
+function checkVersionCompatibility(databaseVersion, clientVersionToCompare) {
const dbVersion = parseSemanticVersion(databaseVersion);
if (!dbVersion) {
return {
@@ -1621,7 +1622,7 @@ function checkVersionCompatibility(databaseVersion) {
isMinorVersionDifference: false
};
}
- const latestClientVersion = VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+ const latestClientVersion = clientVersionToCompare ? VAULT_VERSIONS.find((v) => v.version === clientVersionToCompare) ?? getLatestClientVersion() : getLatestClientVersion();
const clientVersion = parseSemanticVersion(latestClientVersion.version);
if (!clientVersion) {
return {
@@ -1644,6 +1645,9 @@ function checkVersionCompatibility(databaseVersion) {
isMinorVersionDifference
};
}
+function getLatestClientVersion() {
+ return VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+}
function extractVersionFromMigrationId(migrationId) {
const versionRegex = /_(\d+\.\d+\.\d+)-/;
const versionMatch = versionRegex.exec(migrationId);
@@ -1657,5 +1661,6 @@ function extractVersionFromMigrationId(migrationId) {
VAULT_VERSIONS,
VaultSqlGenerator,
checkVersionCompatibility,
- extractVersionFromMigrationId
+ extractVersionFromMigrationId,
+ getLatestClientVersion
});
diff --git a/apps/mobile-app/utils/dist/shared/vault-sql/index.mjs b/apps/mobile-app/utils/dist/shared/vault-sql/index.mjs
index 8418edbf1..cf91a9827 100644
--- a/apps/mobile-app/utils/dist/shared/vault-sql/index.mjs
+++ b/apps/mobile-app/utils/dist/shared/vault-sql/index.mjs
@@ -1568,7 +1568,7 @@ function parseSemanticVersion(version) {
patch: parseInt(match[3], 10)
};
}
-function checkVersionCompatibility(databaseVersion) {
+function checkVersionCompatibility(databaseVersion, clientVersionToCompare) {
const dbVersion = parseSemanticVersion(databaseVersion);
if (!dbVersion) {
return {
@@ -1590,7 +1590,7 @@ function checkVersionCompatibility(databaseVersion) {
isMinorVersionDifference: false
};
}
- const latestClientVersion = VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+ const latestClientVersion = clientVersionToCompare ? VAULT_VERSIONS.find((v) => v.version === clientVersionToCompare) ?? getLatestClientVersion() : getLatestClientVersion();
const clientVersion = parseSemanticVersion(latestClientVersion.version);
if (!clientVersion) {
return {
@@ -1613,6 +1613,9 @@ function checkVersionCompatibility(databaseVersion) {
isMinorVersionDifference
};
}
+function getLatestClientVersion() {
+ return VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+}
function extractVersionFromMigrationId(migrationId) {
const versionRegex = /_(\d+\.\d+\.\d+)-/;
const versionMatch = versionRegex.exec(migrationId);
@@ -1625,5 +1628,6 @@ export {
VAULT_VERSIONS,
VaultSqlGenerator,
checkVersionCompatibility,
- extractVersionFromMigrationId
+ extractVersionFromMigrationId,
+ getLatestClientVersion
};
diff --git a/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.d.mts b/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.d.mts
index bb4891590..d6fc6258b 100644
--- a/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.d.mts
+++ b/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.d.mts
@@ -181,9 +181,16 @@ type VersionCompatibilityResult = {
* while still preventing incompatibilities from major version changes.
*
* @param databaseVersion - The version string from the database migration (e.g., "1.6.1")
+ * @param clientVersionToCompare - Optional client version to compare against (for testing). If not provided, uses the latest version from VAULT_VERSIONS.
* @returns VersionCompatibilityResult with compatibility information
*/
-declare function checkVersionCompatibility(databaseVersion: string): VersionCompatibilityResult;
+declare function checkVersionCompatibility(databaseVersion: string, clientVersionToCompare?: string): VersionCompatibilityResult;
+/**
+ * Get the latest client version from VAULT_VERSIONS.
+ *
+ * @returns The latest VaultVersion
+ */
+declare function getLatestClientVersion(): VaultVersion;
/**
* Extract version from a migration ID.
*
@@ -195,4 +202,4 @@ declare function checkVersionCompatibility(databaseVersion: string): VersionComp
*/
declare function extractVersionFromMigrationId(migrationId: string): string | null;
-export { COMPLETE_SCHEMA_SQL, CreateVaultSqlGenerator, MIGRATION_SCRIPTS, type SqlGenerationResult, VAULT_VERSIONS, VaultSqlGenerator, type VaultVersion, type VaultVersionInfo, type VersionCompatibilityResult, checkVersionCompatibility, extractVersionFromMigrationId };
+export { COMPLETE_SCHEMA_SQL, CreateVaultSqlGenerator, MIGRATION_SCRIPTS, type SqlGenerationResult, VAULT_VERSIONS, VaultSqlGenerator, type VaultVersion, type VaultVersionInfo, type VersionCompatibilityResult, checkVersionCompatibility, extractVersionFromMigrationId, getLatestClientVersion };
diff --git a/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.d.ts b/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.d.ts
index bb4891590..d6fc6258b 100644
--- a/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.d.ts
+++ b/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.d.ts
@@ -181,9 +181,16 @@ type VersionCompatibilityResult = {
* while still preventing incompatibilities from major version changes.
*
* @param databaseVersion - The version string from the database migration (e.g., "1.6.1")
+ * @param clientVersionToCompare - Optional client version to compare against (for testing). If not provided, uses the latest version from VAULT_VERSIONS.
* @returns VersionCompatibilityResult with compatibility information
*/
-declare function checkVersionCompatibility(databaseVersion: string): VersionCompatibilityResult;
+declare function checkVersionCompatibility(databaseVersion: string, clientVersionToCompare?: string): VersionCompatibilityResult;
+/**
+ * Get the latest client version from VAULT_VERSIONS.
+ *
+ * @returns The latest VaultVersion
+ */
+declare function getLatestClientVersion(): VaultVersion;
/**
* Extract version from a migration ID.
*
@@ -195,4 +202,4 @@ declare function checkVersionCompatibility(databaseVersion: string): VersionComp
*/
declare function extractVersionFromMigrationId(migrationId: string): string | null;
-export { COMPLETE_SCHEMA_SQL, CreateVaultSqlGenerator, MIGRATION_SCRIPTS, type SqlGenerationResult, VAULT_VERSIONS, VaultSqlGenerator, type VaultVersion, type VaultVersionInfo, type VersionCompatibilityResult, checkVersionCompatibility, extractVersionFromMigrationId };
+export { COMPLETE_SCHEMA_SQL, CreateVaultSqlGenerator, MIGRATION_SCRIPTS, type SqlGenerationResult, VAULT_VERSIONS, VaultSqlGenerator, type VaultVersion, type VaultVersionInfo, type VersionCompatibilityResult, checkVersionCompatibility, extractVersionFromMigrationId, getLatestClientVersion };
diff --git a/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.js b/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.js
index d70e2ee3b..0cc31d617 100644
--- a/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.js
+++ b/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.js
@@ -29,7 +29,8 @@ __export(index_exports, {
VAULT_VERSIONS: () => VAULT_VERSIONS,
VaultSqlGenerator: () => VaultSqlGenerator,
checkVersionCompatibility: () => checkVersionCompatibility,
- extractVersionFromMigrationId: () => extractVersionFromMigrationId
+ extractVersionFromMigrationId: () => extractVersionFromMigrationId,
+ getLatestClientVersion: () => getLatestClientVersion
});
module.exports = __toCommonJS(index_exports);
@@ -1599,7 +1600,7 @@ function parseSemanticVersion(version) {
patch: parseInt(match[3], 10)
};
}
-function checkVersionCompatibility(databaseVersion) {
+function checkVersionCompatibility(databaseVersion, clientVersionToCompare) {
const dbVersion = parseSemanticVersion(databaseVersion);
if (!dbVersion) {
return {
@@ -1621,7 +1622,7 @@ function checkVersionCompatibility(databaseVersion) {
isMinorVersionDifference: false
};
}
- const latestClientVersion = VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+ const latestClientVersion = clientVersionToCompare ? VAULT_VERSIONS.find((v) => v.version === clientVersionToCompare) ?? getLatestClientVersion() : getLatestClientVersion();
const clientVersion = parseSemanticVersion(latestClientVersion.version);
if (!clientVersion) {
return {
@@ -1644,6 +1645,9 @@ function checkVersionCompatibility(databaseVersion) {
isMinorVersionDifference
};
}
+function getLatestClientVersion() {
+ return VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+}
function extractVersionFromMigrationId(migrationId) {
const versionRegex = /_(\d+\.\d+\.\d+)-/;
const versionMatch = versionRegex.exec(migrationId);
@@ -1657,5 +1661,6 @@ function extractVersionFromMigrationId(migrationId) {
VAULT_VERSIONS,
VaultSqlGenerator,
checkVersionCompatibility,
- extractVersionFromMigrationId
+ extractVersionFromMigrationId,
+ getLatestClientVersion
});
diff --git a/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.mjs b/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.mjs
index 8418edbf1..cf91a9827 100644
--- a/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.mjs
+++ b/apps/server/AliasVault.Client/wwwroot/js/dist/shared/vault-sql/index.mjs
@@ -1568,7 +1568,7 @@ function parseSemanticVersion(version) {
patch: parseInt(match[3], 10)
};
}
-function checkVersionCompatibility(databaseVersion) {
+function checkVersionCompatibility(databaseVersion, clientVersionToCompare) {
const dbVersion = parseSemanticVersion(databaseVersion);
if (!dbVersion) {
return {
@@ -1590,7 +1590,7 @@ function checkVersionCompatibility(databaseVersion) {
isMinorVersionDifference: false
};
}
- const latestClientVersion = VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+ const latestClientVersion = clientVersionToCompare ? VAULT_VERSIONS.find((v) => v.version === clientVersionToCompare) ?? getLatestClientVersion() : getLatestClientVersion();
const clientVersion = parseSemanticVersion(latestClientVersion.version);
if (!clientVersion) {
return {
@@ -1613,6 +1613,9 @@ function checkVersionCompatibility(databaseVersion) {
isMinorVersionDifference
};
}
+function getLatestClientVersion() {
+ return VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+}
function extractVersionFromMigrationId(migrationId) {
const versionRegex = /_(\d+\.\d+\.\d+)-/;
const versionMatch = versionRegex.exec(migrationId);
@@ -1625,5 +1628,6 @@ export {
VAULT_VERSIONS,
VaultSqlGenerator,
checkVersionCompatibility,
- extractVersionFromMigrationId
+ extractVersionFromMigrationId,
+ getLatestClientVersion
};
diff --git a/shared/vault-sql/src/__tests__/VersionCompatibility.test.ts b/shared/vault-sql/src/__tests__/VersionCompatibility.test.ts
index aee1f95d0..50cfd8392 100644
--- a/shared/vault-sql/src/__tests__/VersionCompatibility.test.ts
+++ b/shared/vault-sql/src/__tests__/VersionCompatibility.test.ts
@@ -1,7 +1,36 @@
import { describe, it, expect } from 'vitest';
-import { checkVersionCompatibility, extractVersionFromMigrationId } from '../utils/VersionCompatibility';
+import { checkVersionCompatibility, extractVersionFromMigrationId, getLatestClientVersion } from '../utils/VersionCompatibility';
+import { VAULT_VERSIONS } from '../sql/VaultVersions';
+
+/*
+ * Use a fixed client version for testing to make tests deterministic
+ * and not dependent on the actual latest version in VAULT_VERSIONS
+ */
+const TEST_CLIENT_VERSION = '1.6.0';
describe('VersionCompatibility', () => {
+ describe('getLatestClientVersion', () => {
+ it('should return the latest client version from VAULT_VERSIONS', () => {
+ const result = getLatestClientVersion();
+ const expectedLatest = VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+
+ expect(result).toBeDefined();
+ expect(result).toBe(expectedLatest);
+ expect(result.version).toBe(expectedLatest.version);
+ expect(result.revision).toBe(expectedLatest.revision);
+ expect(result.description).toBe(expectedLatest.description);
+ });
+
+ it('should return a valid VaultVersion object', () => {
+ const result = getLatestClientVersion();
+ expect(result).toHaveProperty('version');
+ expect(result).toHaveProperty('revision');
+ expect(result).toHaveProperty('description');
+ expect(result).toHaveProperty('releaseVersion');
+ expect(result).toHaveProperty('compatibleUpToVersion');
+ });
+ });
+
describe('extractVersionFromMigrationId', () => {
it('should extract version from valid migration ID', () => {
const result = extractVersionFromMigrationId('20240917191243_1.4.1-RenameAttachmentsPlural');
@@ -50,7 +79,7 @@ describe('VersionCompatibility', () => {
describe('Unknown versions - Same major version (backwards compatible)', () => {
it('should be compatible with unknown patch version (1.6.1)', () => {
- const result = checkVersionCompatibility('1.6.1');
+ const result = checkVersionCompatibility('1.6.1', TEST_CLIENT_VERSION);
expect(result.isCompatible).toBe(true);
expect(result.isKnownVersion).toBe(false);
expect(result.isMajorVersionDifference).toBe(false);
@@ -58,7 +87,7 @@ describe('VersionCompatibility', () => {
});
it('should be compatible with unknown patch version (1.6.2)', () => {
- const result = checkVersionCompatibility('1.6.2');
+ const result = checkVersionCompatibility('1.6.2', TEST_CLIENT_VERSION);
expect(result.isCompatible).toBe(true);
expect(result.isKnownVersion).toBe(false);
expect(result.isMajorVersionDifference).toBe(false);
@@ -66,15 +95,15 @@ describe('VersionCompatibility', () => {
});
it('should be compatible with unknown minor version (1.49.0)', () => {
- const result = checkVersionCompatibility('1.49.0');
+ const result = checkVersionCompatibility('1.49.0', TEST_CLIENT_VERSION);
expect(result.isCompatible).toBe(true);
expect(result.isKnownVersion).toBe(false);
expect(result.isMajorVersionDifference).toBe(false);
expect(result.isMinorVersionDifference).toBe(true);
});
- it('should be compatible with unknown minor+patch version (1.49.5)', () => {
- const result = checkVersionCompatibility('1.49.5');
+ it('should be compatible with unknown minor+patch version (1.99.5)', () => {
+ const result = checkVersionCompatibility('1.99.5', TEST_CLIENT_VERSION);
expect(result.isCompatible).toBe(true);
expect(result.isKnownVersion).toBe(false);
expect(result.isMajorVersionDifference).toBe(false);
@@ -84,7 +113,7 @@ describe('VersionCompatibility', () => {
describe('Unknown versions - Different major version (incompatible)', () => {
it('should be incompatible with major version 26.0.0', () => {
- const result = checkVersionCompatibility('26.0.0');
+ const result = checkVersionCompatibility('26.0.0', TEST_CLIENT_VERSION);
expect(result.isCompatible).toBe(false);
expect(result.isKnownVersion).toBe(false);
expect(result.isMajorVersionDifference).toBe(true);
@@ -92,14 +121,14 @@ describe('VersionCompatibility', () => {
});
it('should be incompatible with major version 31.1.5', () => {
- const result = checkVersionCompatibility('31.1.5');
+ const result = checkVersionCompatibility('31.1.5', TEST_CLIENT_VERSION);
expect(result.isCompatible).toBe(false);
expect(result.isKnownVersion).toBe(false);
expect(result.isMajorVersionDifference).toBe(true);
});
it('should be incompatible with major version 0.5.0', () => {
- const result = checkVersionCompatibility('0.5.0');
+ const result = checkVersionCompatibility('0.5.0', TEST_CLIENT_VERSION);
expect(result.isCompatible).toBe(false);
expect(result.isKnownVersion).toBe(false);
expect(result.isMajorVersionDifference).toBe(true);
@@ -131,7 +160,7 @@ describe('VersionCompatibility', () => {
it('should handle version with leading zeros (treats as 1.5.0)', () => {
// Note: parseInt handles leading zeros, so "01.05.00" becomes 1.5.0
- const result = checkVersionCompatibility('01.05.00');
+ const result = checkVersionCompatibility('01.05.00', TEST_CLIENT_VERSION);
expect(result.isCompatible).toBe(true);
expect(result.isKnownVersion).toBe(false);
});
diff --git a/shared/vault-sql/src/utils/VersionCompatibility.ts b/shared/vault-sql/src/utils/VersionCompatibility.ts
index 999aa9488..eeb1aed06 100644
--- a/shared/vault-sql/src/utils/VersionCompatibility.ts
+++ b/shared/vault-sql/src/utils/VersionCompatibility.ts
@@ -71,9 +71,13 @@ function parseSemanticVersion(version: string): { major: number; minor: number;
* while still preventing incompatibilities from major version changes.
*
* @param databaseVersion - The version string from the database migration (e.g., "1.6.1")
+ * @param clientVersionToCompare - Optional client version to compare against (for testing). If not provided, uses the latest version from VAULT_VERSIONS.
* @returns VersionCompatibilityResult with compatibility information
*/
-export function checkVersionCompatibility(databaseVersion: string): VersionCompatibilityResult {
+export function checkVersionCompatibility(
+ databaseVersion: string,
+ clientVersionToCompare?: string
+): VersionCompatibilityResult {
// Parse the database version
const dbVersion = parseSemanticVersion(databaseVersion);
@@ -104,9 +108,12 @@ export function checkVersionCompatibility(databaseVersion: string): VersionCompa
/*
* Unknown version - check semantic versioning compatibility
- * Find the latest version known to this client
+ * Find the latest version known to this client (or use the provided version for testing)
*/
- const latestClientVersion = VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+ const latestClientVersion = clientVersionToCompare
+ ? VAULT_VERSIONS.find(v => v.version === clientVersionToCompare) ?? getLatestClientVersion()
+ : getLatestClientVersion();
+
const clientVersion = parseSemanticVersion(latestClientVersion.version);
if (!clientVersion) {
@@ -137,6 +144,15 @@ export function checkVersionCompatibility(databaseVersion: string): VersionCompa
};
}
+/**
+ * Get the latest client version from VAULT_VERSIONS.
+ *
+ * @returns The latest VaultVersion
+ */
+export function getLatestClientVersion(): VaultVersion {
+ return VAULT_VERSIONS[VAULT_VERSIONS.length - 1];
+}
+
/**
* Extract version from a migration ID.
*