chore: inform users if their fuels version is outdated

.changeset/eleven-jeans-matter.md

@@ -0,0 +1,6 @@
+---
+"@fuel-ts/versions": patch
+"fuels": patch
+---
+
+chore: inform users if their `fuels` version is outdated

packages/fuels/src/cli/utils/checkForAndDisplayUpdates.test.ts

@@ -0,0 +1,68 @@
+import * as versionsMod from '@fuel-ts/versions';
+
+import * as checkForAndDisplayUpdatesMod from './checkForAndDisplayUpdates';
+import * as loggerMod from './logger';
+
+/**
+ * @group node
+ */
+describe('checkForAndDisplayUpdates', () => {
+  beforeEach(() => {
+    vi.resetAllMocks();
+  });
+
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  const mockDeps = (params: { latestVersion: string; userVersion: string }) => {
+    const { latestVersion, userVersion } = params;
+    vi.spyOn(Promise, 'race').mockReturnValue(Promise.resolve(latestVersion));
+
+    vi.spyOn(versionsMod, 'versions', 'get').mockReturnValue({
+      FUELS: userVersion,
+      FORC: '1.0.0',
+      FUEL_CORE: '1.0.0',
+    });
+
+    const log = vi.spyOn(loggerMod, 'log');
+    const warn = vi.spyOn(loggerMod, 'warn');
+
+    return { log, warn };
+  };
+
+  test('should fail gracefully if the fetch fails', async () => {
+    vi.spyOn(global, 'fetch').mockImplementation(() =>
+      Promise.reject(new Error('Failed to fetch'))
+    );
+    const log = vi.spyOn(loggerMod, 'log');
+    await expect(checkForAndDisplayUpdatesMod.checkForAndDisplayUpdates()).resolves.not.toThrow();
+    expect(log).toHaveBeenCalledWith('\n Unable to fetch latest fuels version. Skipping...\n');
+  });
+
+  test('should log a warning if the version is outdated', async () => {
+    const { warn } = mockDeps({ latestVersion: '1.0.1', userVersion: '1.0.0' });
+    await checkForAndDisplayUpdatesMod.checkForAndDisplayUpdates();
+    expect(warn).toHaveBeenCalledWith(
+      '\n⚠️ There is a newer version of fuels available: 1.0.1. Your version is: 1.0.0\n'
+    );
+  });
+
+  test('should log a success message if the version is up to date', async () => {
+    const { log } = mockDeps({ latestVersion: '1.0.0', userVersion: '1.0.0' });
+    await checkForAndDisplayUpdatesMod.checkForAndDisplayUpdates();
+    expect(log).toHaveBeenCalledWith('\n✅ Your fuels version is up to date: 1.0.0\n');
+  });
+
+  test('should handle fetch timing out', async () => {
+    vi.spyOn(global, 'fetch').mockImplementation(
+      () =>
+        new Promise((resolve) => {
+          setTimeout(resolve, 5000);
+        })
+    );
+    const log = vi.spyOn(loggerMod, 'log');
+    await expect(checkForAndDisplayUpdatesMod.checkForAndDisplayUpdates()).resolves.not.toThrow();
+    expect(log).toHaveBeenCalledWith('\n Unable to fetch latest fuels version. Skipping...\n');
+  });
+});

packages/fuels/src/cli/utils/checkForAndDisplayUpdates.ts

@@ -0,0 +1,43 @@
+import { versions, gt, eq } from '@fuel-ts/versions';
+
+import { warn, log } from './logger';
+
+export const getLatestFuelsVersion = async () => {
+  const response = await fetch('https://registry.npmjs.org/fuels/latest');
+  const data = await response.json();
+  return data.version as string;
+};
+
+export const checkForAndDisplayUpdates = async () => {
+  try {
+    const { FUELS: userFuelsVersion } = versions;
+
+    const latestFuelsVersion = await Promise.race<string | undefined>([
+      new Promise((resolve) => {
+        setTimeout(resolve, 3000);
+      }),
+      getLatestFuelsVersion(),
+    ]);
+
+    if (!latestFuelsVersion) {
+      log(`\n Unable to fetch latest fuels version. Skipping...\n`);
+      return;
+    }
+
+    const isFuelsVersionOutdated = gt(latestFuelsVersion, userFuelsVersion);
+    const isFuelsVersionUpToDate = eq(latestFuelsVersion, userFuelsVersion);
+
+    if (isFuelsVersionOutdated) {
+      warn(
+        `\n⚠️ There is a newer version of fuels available: ${latestFuelsVersion}. Your version is: ${userFuelsVersion}\n`
+      );
+      return;
+    }
+
+    if (isFuelsVersionUpToDate) {
+      log(`\n✅ Your fuels version is up to date: ${userFuelsVersion}\n`);
+    }
+  } catch {
+    log(`\n Unable to fetch latest fuels version. Skipping...\n`);
+  }
+};

packages/fuels/src/run.ts

@@ -1,6 +1,8 @@
 import { configureCli } from './cli';
+import { checkForAndDisplayUpdates } from './cli/utils/checkForAndDisplayUpdates';
+import { error } from './cli/utils/logger';
 
 export const run = async (argv: string[]) => {
   const program = configureCli();
-  return program.parseAsync(argv);
+  return Promise.all([await checkForAndDisplayUpdates().catch(error), program.parseAsync(argv)]);
 };

packages/versions/src/index.ts

@@ -41,3 +41,4 @@ export const versions = getBuiltinVersions();
 
 export * from './lib/types';
 export * from './lib/checkFuelCoreVersionCompatibility';
+export * from './lib/semver';