purl: Implement addRegistryUrl() fn

Author: Turbo87

app/utils/purl.js

@@ -0,0 +1,22 @@
+import window from 'ember-window-mock';
+
+/**
+ * Adds a repository_url query parameter to a PURL string based on the host.
+ *
+ * @param {string} purl - The base PURL string (e.g., "pkg:cargo/serde@1.0.0")
+ * @param {string} [host] - The host to use for repository URL. Defaults to current window location host.
+ * @returns {string} The PURL with repository_url parameter added, or unchanged if host is crates.io
+ */
+export function addRegistryUrl(purl) {
+  let host = window.location.host;
+
+  // Don't add repository_url for the main crates.io registry
+  if (host === 'crates.io') {
+    return purl;
+  }
+
+  // Add repository_url query parameter
+  const repositoryUrl = `https://${host}/`;
+  const separator = purl.includes('?') ? '&' : '?';
+  return `${purl}${separator}repository_url=${encodeURIComponent(repositoryUrl)}`;
+}

tests/utils/purl-test.js

@@ -0,0 +1,69 @@
+import { module, test } from 'qunit';
+
+import window from 'ember-window-mock';
+import { setupWindowMock } from 'ember-window-mock/test-support';
+
+import { addRegistryUrl } from 'crates-io/utils/purl';
+
+module('Utils | purl', function (hooks) {
+  setupWindowMock(hooks);
+
+  module('addRegistryUrl()', function () {
+    test('returns PURL unchanged for crates.io host', function (assert) {
+      window.location = 'https://crates.io';
+
+      let purl = 'pkg:cargo/serde@1.0.0';
+      let result = addRegistryUrl(purl);
+
+      assert.strictEqual(result, purl);
+    });
+
+    test('adds repository_url parameter for non-crates.io hosts', function (assert) {
+      window.location = 'https://staging.crates.io';
+
+      let purl = 'pkg:cargo/serde@1.0.0';
+      let result = addRegistryUrl(purl);
+
+      assert.strictEqual(result, 'pkg:cargo/serde@1.0.0?repository_url=https%3A%2F%2Fstaging.crates.io%2F');
+    });
+
+    test('adds repository_url parameter for custom registry hosts', function (assert) {
+      window.location = 'https://my-registry.example.com';
+
+      let purl = 'pkg:cargo/my-crate@2.5.0';
+      let result = addRegistryUrl(purl);
+
+      assert.strictEqual(result, 'pkg:cargo/my-crate@2.5.0?repository_url=https%3A%2F%2Fmy-registry.example.com%2F');
+    });
+
+    test('appends repository_url parameter when PURL already has query parameters', function (assert) {
+      window.location = 'https://staging.crates.io';
+
+      let purl = 'pkg:cargo/serde@1.0.0?arch=x86_64';
+      let result = addRegistryUrl(purl);
+
+      assert.strictEqual(result, 'pkg:cargo/serde@1.0.0?arch=x86_64&repository_url=https%3A%2F%2Fstaging.crates.io%2F');
+    });
+
+    test('properly URL encodes the repository URL', function (assert) {
+      window.location = 'https://registry.example.com:8080';
+
+      let purl = 'pkg:cargo/test@1.0.0';
+      let result = addRegistryUrl(purl);
+
+      assert.strictEqual(result, 'pkg:cargo/test@1.0.0?repository_url=https%3A%2F%2Fregistry.example.com%3A8080%2F');
+    });
+
+    test('handles PURL with complex qualifiers', function (assert) {
+      window.location = 'https://private.registry.co';
+
+      let purl = 'pkg:cargo/complex@1.0.0?os=linux&arch=amd64';
+      let result = addRegistryUrl(purl);
+
+      assert.strictEqual(
+        result,
+        'pkg:cargo/complex@1.0.0?os=linux&arch=amd64&repository_url=https%3A%2F%2Fprivate.registry.co%2F',
+      );
+    });
+  });
+});