feat(devbox): Add devbox manager and nixhub datasource and versioning

lib/constants/category.ts

@@ -8,6 +8,7 @@ const Categories = [
   'ci',
   'custom',
   'dart',
+  'devbox',
   'docker',
   'dotnet',
   'elixir',

lib/modules/datasource/api.ts

@@ -15,6 +15,7 @@ import { CustomDatasource } from './custom';
 import { DartDatasource } from './dart';
 import { DartVersionDatasource } from './dart-version';
 import { DenoDatasource } from './deno';
+import { DevboxDatasource } from './devbox';
 import { DockerDatasource } from './docker';
 import { DotnetVersionDatasource } from './dotnet-version';
 import { EndoflifeDatePackagesource } from './endoflife-date';
@@ -115,6 +116,7 @@ api.set(JavaVersionDatasource.id, new JavaVersionDatasource());
 api.set(JenkinsPluginsDatasource.id, new JenkinsPluginsDatasource());
 api.set(KubernetesApiDatasource.id, new KubernetesApiDatasource());
 api.set(MavenDatasource.id, new MavenDatasource());
+api.set(DevboxDatasource.id, new DevboxDatasource());
 api.set(NodeVersionDatasource.id, new NodeVersionDatasource());
 api.set(NpmDatasource.id, new NpmDatasource());
 api.set(NugetDatasource.id, new NugetDatasource());

lib/modules/datasource/devbox/__fixtures__/releases.json

@@ -0,0 +1,84 @@
+{
+  "name": "nodejs",
+  "summary": "Event-driven I/O framework for the V8 JavaScript engine",
+  "homepage_url": "https://nodejs.org",
+  "license": "MIT",
+  "releases": [
+    {
+      "version": "22.2.0",
+      "last_updated": "2024-05-22T06:18:38Z"
+    },
+    {
+      "version": "22.0.0",
+      "last_updated": "2024-05-12T16:19:40Z"
+    },
+    {
+      "version": "21.7.3",
+      "last_updated": "2024-04-19T21:36:04Z"
+    },
+    {
+      "version": "21.7.2",
+      "last_updated": "2024-04-05T14:44:07Z"
+    },
+    {
+      "version": "21.7.1",
+      "last_updated": "2024-04-02T02:53:36Z"
+    },
+    {
+      "version": "21.7.0",
+      "last_updated": "2024-03-08T13:51:52Z"
+    },
+    {
+      "version": "21.6.2",
+      "last_updated": "2024-02-24T23:06:34Z"
+    },
+    {
+      "version": "21.6.1",
+      "last_updated": "2024-02-10T18:15:24Z"
+    },
+    {
+      "version": "21.6.0",
+      "last_updated": "2024-01-17T15:31:30Z"
+    },
+    {
+      "version": "21.5.0",
+      "last_updated": "2024-01-14T03:55:27Z"
+    },
+    {
+      "version": "21.4.0",
+      "last_updated": "2023-12-18T02:58:18Z"
+    },
+    {
+      "version": "21.3.0",
+      "last_updated": "2023-12-13T22:54:10Z"
+    },
+    {
+      "version": "21.2.0",
+      "last_updated": "2023-11-17T14:14:56Z"
+    },
+    {
+      "version": "21.1.0",
+      "last_updated": "2023-10-25T20:49:13Z"
+    },
+    {
+      "version": "21.0.0",
+      "last_updated": "2023-10-21T11:05:41Z"
+    },
+    {
+      "version": "20.12.2",
+      "last_updated": "2024-05-22T06:18:38Z"
+    },
+    {
+      "version": "20.11.1",
+      "last_updated": "2024-04-02T02:53:36Z"
+    },
+    {
+      "version": "20.11.0",
+      "last_updated": "2024-02-10T18:15:24Z"
+    },
+    {
+      "version": "20.10.0",
+      "last_updated": "2024-01-14T03:55:27Z"
+    }
+  ]
+}

lib/modules/datasource/devbox/common.ts

@@ -0,0 +1,3 @@
+export const defaultRegistryUrl = 'https://search.devbox.sh/v2/';
+
+export const datasource = 'devbox';

lib/modules/datasource/devbox/index.spec.ts

@@ -0,0 +1,88 @@
+import { getPkgReleases } from '..';
+import { Fixtures } from '../../../../test/fixtures';
+import * as httpMock from '../../../../test/http-mock';
+import { EXTERNAL_HOST_ERROR } from '../../../constants/error-messages';
+import { datasource, defaultRegistryUrl } from './common';
+
+const packageName = 'nodejs';
+
+function getPath(packageName: string): string {
+  return `/pkg?name=${packageName}`;
+}
+
+describe('modules/datasource/devbox/index', () => {
+  describe('getReleases', () => {
+    it('throws for error', async () => {
+      httpMock
+        .scope(defaultRegistryUrl)
+        .get(getPath(packageName))
+        .replyWithError('error');
+      await expect(
+        getPkgReleases({
+          datasource,
+          packageName,
+        }),
+      ).rejects.toThrow(EXTERNAL_HOST_ERROR);
+    });
+  });
+
+  it('returns null for 404', async () => {
+    httpMock.scope(defaultRegistryUrl).get(getPath(packageName)).reply(404);
+    expect(
+      await getPkgReleases({
+        datasource,
+        packageName,
+      }),
+    ).toBeNull();
+  });
+
+  it('returns null for empty result', async () => {
+    httpMock.scope(defaultRegistryUrl).get(getPath(packageName)).reply(200, {});
+    expect(
+      await getPkgReleases({
+        datasource,
+        packageName,
+      }),
+    ).toBeNull();
+  });
+
+  it('returns null for empty 200 OK', async () => {
+    httpMock
+      .scope(defaultRegistryUrl)
+      .get(getPath(packageName))
+      .reply(200, { versions: [] });
+    expect(
+      await getPkgReleases({
+        datasource,
+        packageName,
+      }),
+    ).toBeNull();
+  });
+
+  it('throws for 5xx', async () => {
+    httpMock.scope(defaultRegistryUrl).get(getPath(packageName)).reply(502);
+    await expect(
+      getPkgReleases({
+        datasource,
+        packageName,
+      }),
+    ).rejects.toThrow(EXTERNAL_HOST_ERROR);
+  });
+
+  it('processes real data', async () => {
+    httpMock
+      .scope(defaultRegistryUrl)
+      .get(getPath(packageName))
+      .reply(200, Fixtures.get('releases.json'));
+    const res = await getPkgReleases({
+      datasource,
+      packageName,
+    });
+    expect(res?.homepage).toBe('https://nodejs.org');
+    expect(res?.releases[0]).toStrictEqual({
+      version: '20.10.0',
+      releaseTimestamp: '2024-01-14T03:55:27.000Z',
+    });
+    expect(res?.releases).toHaveLength(19);
+  });
+});

lib/modules/datasource/devbox/index.ts

@@ -0,0 +1,57 @@
+import { logger } from '../../../logger';
+import { ExternalHostError } from '../../../types/errors/external-host-error';
+import { HttpError } from '../../../util/http';
+import { joinUrlParts } from '../../../util/url';
+import * as devboxVersioning from '../../versioning/devbox';
+import { Datasource } from '../datasource';
+import type { GetReleasesConfig, ReleaseResult } from '../types';
+import { datasource, defaultRegistryUrl } from './common';
+import type { DevboxResponse } from './types';
+
+export class DevboxDatasource extends Datasource {
+  static readonly id = datasource;
+
+  constructor() {
+    super(datasource);
+  }
+
+  override readonly customRegistrySupport = true;
+  override readonly releaseTimestampSupport = true;
+
+  override readonly registryStrategy = 'first';
+
+  override readonly defaultVersioning = devboxVersioning.id;
+
+  override readonly defaultRegistryUrls = [defaultRegistryUrl];
+
+  async getReleases({
+    registryUrl,
+    packageName,
+  }: GetReleasesConfig): Promise<ReleaseResult | null> {
+    const res: ReleaseResult = {
+      releases: [],
+    };
+
+    logger.trace({ registryUrl, packageName }, 'fetching devbox release');
+
+    const devboxPkgUrl = joinUrlParts(registryUrl!, `/pkg?name=${packageName}`);
+
+    try {
+      const response = await this.http.getJson<DevboxResponse>(devboxPkgUrl);
+      res.homepage = response?.body?.homepage_url;
+      res.releases = response?.body?.releases.map((release) => ({
+        version: release.version,
+        releaseTimestamp: release.last_updated,
+      }));
+    } catch (err) {
+      // istanbul ignore else: not testable with nock
+      if (err instanceof HttpError) {
+        if (err.response?.statusCode !== 404) {
+          throw new ExternalHostError(err);
+        }
+      }
+      this.handleGenericErrors(err);
+    }
+    return res.releases.length ? res : null;
+  }
+}

lib/modules/datasource/devbox/types.ts

@@ -0,0 +1,12 @@
+export interface DevboxRelease {
+  version: string;
+  last_updated: string;
+}
+
+export interface DevboxResponse {
+  name: string;
+  summary: string;
+  homepage_url: string;
+  license: string;
+  releases: DevboxRelease[];
+}

lib/modules/manager/api.ts

@@ -24,6 +24,7 @@ import * as conan from './conan';
 import * as cpanfile from './cpanfile';
 import * as crossplane from './crossplane';
 import * as depsEdn from './deps-edn';
+import * as devbox from './devbox';
 import * as devContainer from './devcontainer';
 import * as dockerCompose from './docker-compose';
 import * as dockerfile from './dockerfile';
@@ -121,6 +122,7 @@ api.set('conan', conan);
 api.set('cpanfile', cpanfile);
 api.set('crossplane', crossplane);
 api.set('deps-edn', depsEdn);
+api.set('devbox', devbox);
 api.set('devcontainer', devContainer);
 api.set('docker-compose', dockerCompose);
 api.set('dockerfile', dockerfile);