@metaplay/metaplay-auth 1.9.1 → 1.9.2

package/index.ts

@@ -13,7 +13,7 @@ import { portalBaseUrl, setPortalBaseUrl } from './src/config.js'
 import { checkGameServerDeployment, debugGameServer } from './src/deployment.js'
 import { logger, setLogLevel } from './src/logging.js'
 import { TargetEnvironment } from './src/targetenvironment.js'
-import { isValidFQDN, removeTrailingSlash, fetchHelmChartVersions, resolveBestMatchingVersion, executeHelmCommand, getGameServerHelmRelease } from './src/utils.js'
+import { isValidFQDN, removeTrailingSlash, fetchHelmChartVersions, resolveBestMatchingVersion, checkHelmVersion, executeHelmCommand, getGameServerHelmRelease } from './src/utils.js'
 import { PACKAGE_VERSION } from './src/version.js'
 
 /** Stack API base url override, specified with the '--stack-api' global flag. */
@@ -250,6 +250,10 @@ program
       setLogLevel(10)
     }
 
+    // Show a deprecation warning.
+    console.warn('Warning: The metaplay-auth CLI is deprecated and will only receive critical updates.')
+    console.warn('         Please upgrade to Metaplay SDK release 32 or newer and the new Metaplay CLI (https://github.com/metaplay/cli).')
+
     // Store the portal base URL for accessing globally
     const overridePortalUrl: string | undefined = opts.portalBaseUrl ?? process.env.AUTHCLI_PORTAL_BASEURL
     if (overridePortalUrl) {
@@ -783,6 +787,9 @@ program
         }
         logger.debug('Resolved Helm chart version: ', resolvedHelmChartVersion)
 
+        // Check that the Helm version is compatible
+        await checkHelmVersion()
+
         // Fetch kubeconfig and write it to a temporary file
         // \todo allow passing a custom kubeconfig file?
         const kubeconfigPayload = await targetEnv.getKubeConfigWithEmbeddedCredentials()
@@ -866,6 +873,9 @@ program
           exit(0)
         }
 
+        // Check that the Helm version is compatible
+        await checkHelmVersion()
+
         // Construct Helm invocation.
         const deploymentName = gameServerHelmRelease.name
         const helmArgs = ['uninstall', '--wait'] // \note waits for resources to be deleted before returning

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@metaplay/metaplay-auth",
   "description": "Utility CLI for authenticating with the Metaplay Auth and making authenticated calls to infrastructure endpoints.",
-  "version": "1.9.1",
+  "version": "1.9.2",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://metaplay.io",

package/src/auth.ts

@@ -323,7 +323,6 @@ async function extendCurrentSessionWithRefreshToken(
  * @param code
  * @returns
  */
-
 async function getTokensWithAuthorizationCode(
   state: string,
   redirectUri: string,

package/src/utils.ts

@@ -220,6 +220,58 @@ export function resolveBestMatchingVersion(versions: string[], range: semver.Ran
   return sortedVersions[0]
 }
 
+/**
+ * Check that the installed Helm version is compatible with the required version range.
+ * Validates that Helm version is >= 3.18.0 and < 3.18.5.
+ *
+ * Version 3.18.5 (and recent other patch versions) tightened up the Helm chart validation logic
+ * and we can't retroactively fix the charts. The path forward is to upgrade to more recent Metaplay
+ * SDK versions and switch to the new CLI (https://github.com/metaplay/cli).
+ *
+ * @throws Error if Helm is not installed, version cannot be determined, or version is incompatible
+ */
+export async function checkHelmVersion(): Promise<void> {
+  try {
+    // Execute 'helm version' command to get version information
+    const result = await executeCommand('helm', ['version', '--short'])
+
+    if (result.exitCode !== 0) {
+      throw new Error(`Helm version command failed with exit code ${result.exitCode}: ${result.stderr.join('')}`)
+    }
+
+    // Parse version from output (format: "v3.18.0+g123abc")
+    const versionOutput = result.stdout.join('').trim()
+    const versionRegex = /v(\d+\.\d+\.\d+)/
+    const versionMatch = versionRegex.exec(versionOutput)
+
+    if (!versionMatch) {
+      throw new Error(`Could not parse Helm version from output: ${versionOutput}`)
+    }
+
+    const helmVersion = versionMatch[1]
+    logger.debug(`Detected Helm version: ${helmVersion}`)
+
+    // Check version constraints: >= 3.18.0 and <= 3.18.4
+    const minVersion = '3.18.0'
+    const maxVersion = '3.18.4'
+
+    if (!semver.gte(helmVersion, minVersion)) {
+      throw new Error(`Locally installed Helm version ${helmVersion} is too old. Use Helm v${maxVersion} which is the latest compatible version`)
+    }
+
+    if (!semver.lte(helmVersion, maxVersion)) {
+      throw new Error(`Locally installed Helm version ${helmVersion} is too new. Use Helm v${maxVersion} which is the latest compatible version`)
+    }
+
+    logger.debug(`Helm version ${helmVersion} is compatible`)
+  } catch (error) {
+    if (error instanceof Error && error.message.includes('ENOENT')) {
+      throw new Error('Helm is not installed or not found in PATH. Please install Helm version >= 3.18.0 and < 3.18.5')
+    }
+    throw error
+  }
+}
+
 /**
  * Execute a Helm command by invoking the Helm CLI client with the given kubeconfig and arguments to `helm`.
  * The provided kubeconfig is written to a temporary file and cleaned up after, and passed to `helm` with

package/src/version.ts

@@ -1 +1 @@
-export const PACKAGE_VERSION = "1.9.1"
+export const PACKAGE_VERSION = "1.9.2"