@equinor/fusion-framework-module-msal 5.0.0 → 5.1.0

package/src/versioning/resolve-version.ts

@@ -52,63 +52,69 @@ export function resolveVersion(version?: string | SemVer): ResolvedVersion {
   const versionString = version || MsalModuleVersion.Latest;
 
   // Parse versions using coerce for backward compatibility
-  const wantedVersion = semver.coerce(versionString);
   const latestVersion = semver.coerce(MsalModuleVersion.Latest);
 
-  // Validate that the requested version is a valid semver
-  if (!wantedVersion) {
-    throw VersionError.create(
-      VersionError.Type.InvalidVersion,
+  // This should never happen! Indicates version.ts was not generated correctly
+  // This is a critical build-time issue that needs immediate attention
+  if (!latestVersion) {
+    throw new VersionError(
+      `Failed to parse latest version "${MsalModuleVersion.Latest}" - this indicates the version.ts file was not generated correctly. Check for import errors in the build process.`,
       versionString,
       MsalModuleVersion.Latest,
     );
   }
 
-  // This should never happen! Indicates version.ts was not generated correctly
-  // This is a critical build-time issue that needs immediate attention
-  if (!latestVersion) {
-    throw VersionError.create(
-      VersionError.Type.InvalidLatestVersion,
+  let wantedVersion: SemVer | null = semver.coerce(versionString);
+  // Validate that the requested version is a valid semver
+  if (!wantedVersion) {
+    const missingVersionWarning = new VersionError(
+      `Failed to parse requested version "${versionString}"`,
       versionString,
       MsalModuleVersion.Latest,
     );
+    warnings.push(missingVersionWarning.message);
+    wantedVersion = latestVersion;
   }
 
-  // Major version incompatibility check - this is a hard error
-  // Users cannot request a major version that doesn't exist yet
-  if (wantedVersion.major > latestVersion.major) {
-    throw VersionError.create(
-      VersionError.Type.MajorIncompatibility,
-      String(wantedVersion),
-      String(latestVersion),
+  if (wantedVersion.major < latestVersion.major) {
+    const majorBehindVersionWarning = new VersionError(
+      `Requested major version ${wantedVersion.major} is behind the latest major version ${latestVersion.major}`,
+      wantedVersion,
+      latestVersion,
     );
+    warnings.push(majorBehindVersionWarning.message);
   }
 
   // Minor version mismatch - add warning but don't throw
   // This helps developers stay aware of version differences without breaking functionality
   if (wantedVersion.major === latestVersion.major && wantedVersion.minor !== latestVersion.minor) {
-    const minorMismatchWarning = VersionError.create(
-      VersionError.Type.MinorMismatch,
-      String(wantedVersion),
-      String(latestVersion),
+    const minorMismatchWarning = new VersionError(
+      `Requested minor version ${wantedVersion.minor} is different from the latest minor version ${latestVersion.minor}`,
+      wantedVersion,
+      latestVersion,
     );
     warnings.push(minorMismatchWarning.message);
   }
 
   // Find the corresponding enum version for the requested major version
   // This is used for module configuration and feature detection
-  const enumVersion = Object.values(MsalModuleVersion).find(
+  let enumVersion = Object.values(MsalModuleVersion).find(
     (x) => semver.coerce(x)?.major === wantedVersion.major,
   );
 
-  // If no matching enum version is found, this indicates a major version
-  // that doesn't have a corresponding enum value defined
+  // If no matching enum version is found, fall back to the latest available
+  // This allows forward compatibility with future versions
   if (!enumVersion) {
-    throw VersionError.create(
-      VersionError.Type.MajorIncompatibility,
-      String(wantedVersion),
-      String(latestVersion),
-    );
+    enumVersion = MsalModuleVersion.Latest;
+    // Only warn if this is a future version (higher than latest)
+    if (wantedVersion.major > latestVersion.major) {
+      const fallbackWarning = new VersionError(
+        `Requested major version ${wantedVersion.major} is greater than the latest major version ${latestVersion.major}. Falling back to latest version.`,
+        wantedVersion,
+        latestVersion,
+      );
+      warnings.push(fallbackWarning.message);
+    }
   }
 
   // Return comprehensive version resolution result

package/dist/esm/versioning/create-version-message.js

@@ -1,54 +0,0 @@
-import { VersionMessageType } from './static';
-/**
- * Creates a human-readable version message based on the version message type.
- *
- * This function generates descriptive error messages for different version compatibility
- * scenarios, helping developers understand version-related issues.
- *
- * @param type - The type of version message to create
- * @param requestedVersion - The version that was requested by the user
- * @param latestVersion - The latest available version in the system
- * @returns A formatted, human-readable version message string
- *
- * @example
- * ```typescript
- * const message = createVersionMessage(
- *   VersionMessageType.MajorIncompatibility,
- *   '3.0.0',
- *   '2.1.0'
- * );
- * // Returns: "Requested major version 3.0.0 is greater than the latest major version 2.1.0"
- * ```
- *
- * @example
- * ```typescript
- * const message = createVersionMessage(
- *   VersionMessageType.MinorMismatch,
- *   '2.1.0',
- *   '2.2.0'
- * );
- * // Returns: "Minor version mismatch, requested 2.1.0, latest 2.2.0"
- * ```
- */
-export const createVersionMessage = (type, requestedVersion, latestVersion) => {
-    // Convert versions to strings for consistent formatting
-    const requestedVersionString = String(requestedVersion);
-    const latestVersionString = String(latestVersion);
-    switch (type) {
-        case VersionMessageType.MajorIncompatibility:
-            return `Requested major version ${requestedVersionString} is greater than the latest major version ${latestVersionString}`;
-        case VersionMessageType.InvalidVersion:
-            return `Invalid version ${requestedVersionString}`;
-        case VersionMessageType.InvalidLatestVersion:
-            return `Failed to parse latest version "${latestVersionString}" - this indicates the version.ts file was not generated correctly. Check for import errors in the build process.`;
-        case VersionMessageType.MinorMismatch:
-            return `Minor version mismatch, requested ${requestedVersionString}, latest ${latestVersionString}`;
-        case VersionMessageType.PatchDifference:
-            return `Patch version difference, requested ${requestedVersionString}, latest ${latestVersionString}`;
-        case VersionMessageType.IncompatibleVersion:
-            return `Incompatible version, requested ${requestedVersionString}, latest ${latestVersionString}`;
-        default:
-            return createVersionMessage(VersionMessageType.IncompatibleVersion, requestedVersion, latestVersion);
-    }
-};
-//# sourceMappingURL=create-version-message.js.map

package/dist/esm/versioning/create-version-message.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-version-message.js","sourceRoot":"","sources":["../../../src/versioning/create-version-message.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,IAAwB,EACxB,gBAAiC,EACjC,aAA8B,EACtB,EAAE;IACV,wDAAwD;IACxD,MAAM,sBAAsB,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACxD,MAAM,mBAAmB,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IAClD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,kBAAkB,CAAC,oBAAoB;YAC1C,OAAO,2BAA2B,sBAAsB,6CAA6C,mBAAmB,EAAE,CAAC;QAC7H,KAAK,kBAAkB,CAAC,cAAc;YACpC,OAAO,mBAAmB,sBAAsB,EAAE,CAAC;QACrD,KAAK,kBAAkB,CAAC,oBAAoB;YAC1C,OAAO,mCAAmC,mBAAmB,mHAAmH,CAAC;QACnL,KAAK,kBAAkB,CAAC,aAAa;YACnC,OAAO,qCAAqC,sBAAsB,YAAY,mBAAmB,EAAE,CAAC;QACtG,KAAK,kBAAkB,CAAC,eAAe;YACrC,OAAO,uCAAuC,sBAAsB,YAAY,mBAAmB,EAAE,CAAC;QACxG,KAAK,kBAAkB,CAAC,mBAAmB;YACzC,OAAO,mCAAmC,sBAAsB,YAAY,mBAAmB,EAAE,CAAC;QACpG;YACE,OAAO,oBAAoB,CACzB,kBAAkB,CAAC,mBAAmB,EACtC,gBAAgB,EAChB,aAAa,CACd,CAAC;IACN,CAAC;AACH,CAAC,CAAC"}

package/dist/esm/versioning/static.js

@@ -1,10 +0,0 @@
-export var VersionMessageType;
-(function (VersionMessageType) {
-    VersionMessageType["MajorIncompatibility"] = "major-incompatibility";
-    VersionMessageType["MinorMismatch"] = "minor-mismatch";
-    VersionMessageType["PatchDifference"] = "patch-difference";
-    VersionMessageType["InvalidVersion"] = "invalid-version";
-    VersionMessageType["InvalidLatestVersion"] = "invalid-latest-version";
-    VersionMessageType["IncompatibleVersion"] = "incompatible-version";
-})(VersionMessageType || (VersionMessageType = {}));
-//# sourceMappingURL=static.js.map

package/dist/esm/versioning/static.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"static.js","sourceRoot":"","sources":["../../../src/versioning/static.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC5B,oEAA8C,CAAA;IAC9C,sDAAgC,CAAA;IAChC,0DAAoC,CAAA;IACpC,wDAAkC,CAAA;IAClC,qEAA+C,CAAA;IAC/C,kEAA4C,CAAA;AAC9C,CAAC,EAPW,kBAAkB,KAAlB,kBAAkB,QAO7B"}

package/dist/types/versioning/create-version-message.d.ts

@@ -1,34 +0,0 @@
-import type { SemVer } from 'semver';
-import { VersionMessageType } from './static';
-/**
- * Creates a human-readable version message based on the version message type.
- *
- * This function generates descriptive error messages for different version compatibility
- * scenarios, helping developers understand version-related issues.
- *
- * @param type - The type of version message to create
- * @param requestedVersion - The version that was requested by the user
- * @param latestVersion - The latest available version in the system
- * @returns A formatted, human-readable version message string
- *
- * @example
- * ```typescript
- * const message = createVersionMessage(
- *   VersionMessageType.MajorIncompatibility,
- *   '3.0.0',
- *   '2.1.0'
- * );
- * // Returns: "Requested major version 3.0.0 is greater than the latest major version 2.1.0"
- * ```
- *
- * @example
- * ```typescript
- * const message = createVersionMessage(
- *   VersionMessageType.MinorMismatch,
- *   '2.1.0',
- *   '2.2.0'
- * );
- * // Returns: "Minor version mismatch, requested 2.1.0, latest 2.2.0"
- * ```
- */
-export declare const createVersionMessage: (type: VersionMessageType, requestedVersion: string | SemVer, latestVersion: string | SemVer) => string;

package/dist/types/versioning/static.d.ts

@@ -1,8 +0,0 @@
-export declare enum VersionMessageType {
-    MajorIncompatibility = "major-incompatibility",
-    MinorMismatch = "minor-mismatch",
-    PatchDifference = "patch-difference",
-    InvalidVersion = "invalid-version",
-    InvalidLatestVersion = "invalid-latest-version",
-    IncompatibleVersion = "incompatible-version"
-}

package/src/versioning/create-version-message.ts

@@ -1,63 +0,0 @@
-import type { SemVer } from 'semver';
-import { VersionMessageType } from './static';
-
-/**
- * Creates a human-readable version message based on the version message type.
- *
- * This function generates descriptive error messages for different version compatibility
- * scenarios, helping developers understand version-related issues.
- *
- * @param type - The type of version message to create
- * @param requestedVersion - The version that was requested by the user
- * @param latestVersion - The latest available version in the system
- * @returns A formatted, human-readable version message string
- *
- * @example
- * ```typescript
- * const message = createVersionMessage(
- *   VersionMessageType.MajorIncompatibility,
- *   '3.0.0',
- *   '2.1.0'
- * );
- * // Returns: "Requested major version 3.0.0 is greater than the latest major version 2.1.0"
- * ```
- *
- * @example
- * ```typescript
- * const message = createVersionMessage(
- *   VersionMessageType.MinorMismatch,
- *   '2.1.0',
- *   '2.2.0'
- * );
- * // Returns: "Minor version mismatch, requested 2.1.0, latest 2.2.0"
- * ```
- */
-export const createVersionMessage = (
-  type: VersionMessageType,
-  requestedVersion: string | SemVer,
-  latestVersion: string | SemVer,
-): string => {
-  // Convert versions to strings for consistent formatting
-  const requestedVersionString = String(requestedVersion);
-  const latestVersionString = String(latestVersion);
-  switch (type) {
-    case VersionMessageType.MajorIncompatibility:
-      return `Requested major version ${requestedVersionString} is greater than the latest major version ${latestVersionString}`;
-    case VersionMessageType.InvalidVersion:
-      return `Invalid version ${requestedVersionString}`;
-    case VersionMessageType.InvalidLatestVersion:
-      return `Failed to parse latest version "${latestVersionString}" - this indicates the version.ts file was not generated correctly. Check for import errors in the build process.`;
-    case VersionMessageType.MinorMismatch:
-      return `Minor version mismatch, requested ${requestedVersionString}, latest ${latestVersionString}`;
-    case VersionMessageType.PatchDifference:
-      return `Patch version difference, requested ${requestedVersionString}, latest ${latestVersionString}`;
-    case VersionMessageType.IncompatibleVersion:
-      return `Incompatible version, requested ${requestedVersionString}, latest ${latestVersionString}`;
-    default:
-      return createVersionMessage(
-        VersionMessageType.IncompatibleVersion,
-        requestedVersion,
-        latestVersion,
-      );
-  }
-};

package/src/versioning/static.ts

@@ -1,8 +0,0 @@
-export enum VersionMessageType {
-  MajorIncompatibility = 'major-incompatibility',
-  MinorMismatch = 'minor-mismatch',
-  PatchDifference = 'patch-difference',
-  InvalidVersion = 'invalid-version',
-  InvalidLatestVersion = 'invalid-latest-version',
-  IncompatibleVersion = 'incompatible-version',
-}