@red-hat-developer-hub/e2e-test-utils 1.1.24 → 1.1.26

package/dist/utils/tests/plugin-metadata.nightly.test.js

@@ -0,0 +1,178 @@
+/**
+ * Nightly mode tests — isNightlyJob detection and nightly plugin resolution.
+ */
+import { describe, it, beforeEach, afterEach } from "node:test";
+import assert from "node:assert";
+import fs from "fs-extra";
+import { isNightlyJob, processPluginsForDeployment, } from "../plugin-metadata.js";
+import { withCleanEnv, createMetadataFixture } from "./helpers.js";
+// ── isNightlyJob ─────────────────────────────────────────────────────────────
+describe("isNightlyJob", () => {
+    const env = withCleanEnv();
+    beforeEach(() => env.save());
+    afterEach(() => env.restore());
+    it("returns false with no env vars set", () => {
+        delete process.env.E2E_NIGHTLY_MODE;
+        delete process.env.JOB_NAME;
+        delete process.env.GIT_PR_NUMBER;
+        assert.strictEqual(isNightlyJob(), false);
+    });
+    it("returns true when E2E_NIGHTLY_MODE is 'true'", () => {
+        delete process.env.GIT_PR_NUMBER;
+        process.env.E2E_NIGHTLY_MODE = "true";
+        assert.strictEqual(isNightlyJob(), true);
+    });
+    it("returns true when E2E_NIGHTLY_MODE is '1'", () => {
+        delete process.env.GIT_PR_NUMBER;
+        process.env.E2E_NIGHTLY_MODE = "1";
+        assert.strictEqual(isNightlyJob(), true);
+    });
+    it("returns false when E2E_NIGHTLY_MODE is 'false' (strict check)", () => {
+        delete process.env.GIT_PR_NUMBER;
+        process.env.E2E_NIGHTLY_MODE = "false";
+        assert.strictEqual(isNightlyJob(), false, "'false' string must not trigger nightly mode");
+    });
+    it("returns false when E2E_NIGHTLY_MODE is empty string", () => {
+        delete process.env.GIT_PR_NUMBER;
+        process.env.E2E_NIGHTLY_MODE = "";
+        assert.strictEqual(isNightlyJob(), false, "empty string must not trigger nightly mode");
+    });
+    it("returns true when JOB_NAME contains 'periodic-'", () => {
+        delete process.env.GIT_PR_NUMBER;
+        delete process.env.E2E_NIGHTLY_MODE;
+        process.env.JOB_NAME = "periodic-ci-overlay-e2e-nightly";
+        assert.strictEqual(isNightlyJob(), true);
+    });
+    it("returns false when JOB_NAME contains 'periodic' without trailing dash", () => {
+        delete process.env.GIT_PR_NUMBER;
+        delete process.env.E2E_NIGHTLY_MODE;
+        process.env.JOB_NAME = "run-periodically";
+        assert.strictEqual(isNightlyJob(), false, "'periodic' without dash must not trigger nightly mode");
+    });
+    it("returns false when GIT_PR_NUMBER is set (PR takes precedence)", () => {
+        process.env.GIT_PR_NUMBER = "42";
+        process.env.E2E_NIGHTLY_MODE = "true";
+        assert.strictEqual(isNightlyJob(), false, "GIT_PR_NUMBER must take precedence over nightly mode");
+    });
+    it("returns false when GIT_PR_NUMBER is set even with periodic JOB_NAME", () => {
+        process.env.GIT_PR_NUMBER = "42";
+        process.env.JOB_NAME = "periodic-ci-overlay-e2e-nightly";
+        assert.strictEqual(isNightlyJob(), false, "GIT_PR_NUMBER must take precedence over periodic job detection");
+    });
+});
+// ── Nightly resolution scenarios ─────────────────────────────────────────────
+describe("processPluginsForDeployment — nightly mode", () => {
+    const env = withCleanEnv();
+    beforeEach(() => {
+        env.save();
+        delete process.env.GIT_PR_NUMBER;
+        process.env.E2E_NIGHTLY_MODE = "true";
+    });
+    afterEach(() => env.restore());
+    it("skips metadata injection in nightly mode", async () => {
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "backstage-community-plugin-tech-radar",
+                packageName: "@backstage-community/plugin-tech-radar",
+                dynamicArtifact: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                appConfigExamples: {
+                    techRadar: { url: "http://default.example.com" },
+                },
+            },
+        ]);
+        try {
+            const config = {
+                plugins: [
+                    {
+                        package: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                        disabled: false,
+                    },
+                ],
+            };
+            const result = await processPluginsForDeployment(config, metadataDir);
+            assert.strictEqual(result.plugins[0].pluginConfig, undefined, "nightly mode must NOT inject metadata pluginConfig");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+    it("preserves user-provided pluginConfig in nightly mode", async () => {
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "backstage-community-plugin-tech-radar",
+                packageName: "@backstage-community/plugin-tech-radar",
+                dynamicArtifact: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                appConfigExamples: {
+                    techRadar: { url: "http://metadata.example.com" },
+                },
+            },
+        ]);
+        try {
+            const userPluginConfig = {
+                techRadar: { url: "http://user.example.com" },
+            };
+            const config = {
+                plugins: [
+                    {
+                        package: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                        disabled: false,
+                        pluginConfig: userPluginConfig,
+                    },
+                ],
+            };
+            const result = await processPluginsForDeployment(config, metadataDir);
+            assert.deepStrictEqual(result.plugins[0].pluginConfig, userPluginConfig, "nightly mode must preserve user pluginConfig exactly as-is");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+    it("resolves OCI plugin to metadata dynamicArtifact in nightly", async () => {
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "backstage-community-plugin-tekton",
+                packageName: "@backstage-community/plugin-tekton",
+                dynamicArtifact: "oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-tekton:bs_1.45.3__3.33.3!backstage-community-plugin-tekton",
+            },
+        ]);
+        try {
+            const config = {
+                plugins: [
+                    {
+                        package: "oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-tekton:old_stale_tag!backstage-community-plugin-tekton",
+                        disabled: false,
+                    },
+                ],
+            };
+            const result = await processPluginsForDeployment(config, metadataDir);
+            assert.ok(result.plugins[0].package.includes("bs_1.45.3__3.33.3"), "nightly must resolve to metadata dynamicArtifact (latest published version)");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+    it("keeps local path plugins unchanged in nightly", async () => {
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "red-hat-developer-hub-backstage-plugin-quickstart",
+                packageName: "@red-hat-developer-hub/backstage-plugin-quickstart",
+                dynamicArtifact: "./dynamic-plugins/dist/red-hat-developer-hub-backstage-plugin-quickstart",
+            },
+        ]);
+        try {
+            const config = {
+                plugins: [
+                    {
+                        package: "./dynamic-plugins/dist/red-hat-developer-hub-backstage-plugin-quickstart",
+                        disabled: false,
+                    },
+                ],
+            };
+            const result = await processPluginsForDeployment(config, metadataDir);
+            assert.strictEqual(result.plugins[0].package, "./dynamic-plugins/dist/red-hat-developer-hub-backstage-plugin-quickstart", "local path plugins must not be converted to OCI in nightly");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+});

package/dist/utils/tests/plugin-metadata.pr.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin-metadata.pr.test.d.ts.map

package/dist/utils/tests/plugin-metadata.pr.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-metadata.pr.test.d.ts","sourceRoot":"","sources":["../../../src/utils/tests/plugin-metadata.pr.test.ts"],"names":[],"mappings":""}

package/dist/utils/tests/plugin-metadata.pr.test.js

@@ -0,0 +1,296 @@
+/**
+ * PR mode tests — metadata injection, OCI resolution, skip injection, precedence.
+ */
+import { describe, it, beforeEach, afterEach } from "node:test";
+import assert from "node:assert";
+import fs from "fs-extra";
+import { isNightlyJob, processPluginsForDeployment, } from "../plugin-metadata.js";
+import { withCleanEnv, createMetadataFixture, createWorkspaceFixture, } from "./helpers.js";
+describe("processPluginsForDeployment — PR mode", () => {
+    const env = withCleanEnv();
+    beforeEach(() => {
+        env.save();
+        delete process.env.E2E_NIGHTLY_MODE;
+        delete process.env.JOB_NAME;
+        delete process.env.GIT_PR_NUMBER;
+    });
+    afterEach(() => env.restore());
+    it("injects appConfigExamples from metadata as base pluginConfig", async () => {
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "backstage-community-plugin-tech-radar",
+                packageName: "@backstage-community/plugin-tech-radar",
+                dynamicArtifact: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                appConfigExamples: {
+                    techRadar: { url: "http://default.example.com" },
+                },
+            },
+        ]);
+        try {
+            const config = {
+                plugins: [
+                    {
+                        package: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                        disabled: false,
+                    },
+                ],
+            };
+            const result = await processPluginsForDeployment(config, metadataDir);
+            assert.deepStrictEqual(result.plugins[0].pluginConfig, { techRadar: { url: "http://default.example.com" } }, "metadata appConfigExamples must be injected as pluginConfig in PR mode");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+    it("user pluginConfig overrides metadata appConfigExamples", async () => {
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "backstage-community-plugin-tech-radar",
+                packageName: "@backstage-community/plugin-tech-radar",
+                dynamicArtifact: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                appConfigExamples: {
+                    techRadar: { url: "http://default.example.com" },
+                },
+            },
+        ]);
+        try {
+            const config = {
+                plugins: [
+                    {
+                        package: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                        disabled: false,
+                        pluginConfig: {
+                            techRadar: { url: "http://custom.example.com" },
+                        },
+                    },
+                ],
+            };
+            const result = await processPluginsForDeployment(config, metadataDir);
+            assert.strictEqual(result.plugins[0].pluginConfig
+                .techRadar &&
+                result.plugins[0].pluginConfig
+                    .techRadar.url, "http://custom.example.com", "user pluginConfig must override metadata defaults");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+    it("resolves OCI plugin to metadata dynamicArtifact when no PR number", async () => {
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "backstage-community-plugin-tekton",
+                packageName: "@backstage-community/plugin-tekton",
+                dynamicArtifact: "oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-tekton:bs_1.45.3__3.33.3!backstage-community-plugin-tekton",
+            },
+        ]);
+        try {
+            const config = {
+                plugins: [
+                    {
+                        package: "oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-tekton:old_tag!backstage-community-plugin-tekton",
+                        disabled: false,
+                    },
+                ],
+            };
+            const result = await processPluginsForDeployment(config, metadataDir);
+            assert.strictEqual(result.plugins[0].package, "oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-tekton:bs_1.45.3__3.33.3!backstage-community-plugin-tekton", "OCI plugin must be resolved to metadata dynamicArtifact");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+    it("keeps local path plugins unchanged", async () => {
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "backstage-community-plugin-tech-radar",
+                packageName: "@backstage-community/plugin-tech-radar",
+                dynamicArtifact: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+            },
+        ]);
+        try {
+            const config = {
+                plugins: [
+                    {
+                        package: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                        disabled: false,
+                    },
+                ],
+            };
+            const result = await processPluginsForDeployment(config, metadataDir);
+            assert.strictEqual(result.plugins[0].package, "./dynamic-plugins/dist/backstage-community-plugin-tech-radar", "local path plugins must stay unchanged");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+    it("keeps plugins without metadata unchanged", async () => {
+        const metadataDir = await createMetadataFixture([]);
+        try {
+            const keycloakPackage = "./dynamic-plugins/dist/backstage-community-plugin-catalog-backend-module-keycloak-dynamic";
+            const config = {
+                plugins: [{ package: keycloakPackage, disabled: false }],
+            };
+            const result = await processPluginsForDeployment(config, metadataDir);
+            assert.strictEqual(result.plugins[0].package, keycloakPackage, "plugins not in workspace metadata must stay unchanged");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+    it("resolves OCI plugin from different registry using metadata ref", async () => {
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "backstage-plugin-events-backend-module-github",
+                packageName: "@backstage/plugin-events-backend-module-github",
+                dynamicArtifact: "oci://quay.io/rhdh/backstage-plugin-events-backend-module-github@sha256:abc123",
+            },
+        ]);
+        try {
+            const config = {
+                plugins: [
+                    {
+                        package: "oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-plugin-events-backend-module-github:bs_1.45.3__0.4.6",
+                        disabled: false,
+                    },
+                ],
+            };
+            const result = await processPluginsForDeployment(config, metadataDir);
+            assert.ok(result.plugins[0].package.startsWith("oci://quay.io/rhdh/"), "must use the actual registry from metadata, not hardcoded ghcr.io");
+            assert.strictEqual(result.plugins[0].package, "oci://quay.io/rhdh/backstage-plugin-events-backend-module-github@sha256:abc123", "must use metadata dynamicArtifact exactly");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+    it("skips injection when RHDH_SKIP_PLUGIN_METADATA_INJECTION is 'true'", async () => {
+        process.env.RHDH_SKIP_PLUGIN_METADATA_INJECTION = "true";
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "backstage-community-plugin-tech-radar",
+                packageName: "@backstage-community/plugin-tech-radar",
+                dynamicArtifact: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                appConfigExamples: {
+                    techRadar: { url: "http://default.example.com" },
+                },
+            },
+        ]);
+        try {
+            const config = {
+                plugins: [
+                    {
+                        package: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                        disabled: false,
+                    },
+                ],
+            };
+            const result = await processPluginsForDeployment(config, metadataDir);
+            assert.strictEqual(result.plugins[0].pluginConfig, undefined, "pluginConfig must not be injected when RHDH_SKIP_PLUGIN_METADATA_INJECTION=true");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+    it("does not skip injection when RHDH_SKIP_PLUGIN_METADATA_INJECTION is 'false'", async () => {
+        process.env.RHDH_SKIP_PLUGIN_METADATA_INJECTION = "false";
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "backstage-community-plugin-tech-radar",
+                packageName: "@backstage-community/plugin-tech-radar",
+                dynamicArtifact: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                appConfigExamples: { techRadar: { url: "http://example.com" } },
+            },
+        ]);
+        try {
+            const config = {
+                plugins: [
+                    {
+                        package: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                        disabled: false,
+                    },
+                ],
+            };
+            const result = await processPluginsForDeployment(config, metadataDir);
+            assert.ok(result.plugins[0].pluginConfig, "pluginConfig must be injected when RHDH_SKIP_PLUGIN_METADATA_INJECTION='false' (strict check)");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+    it("resolves mixed plugin types correctly in a single config", async () => {
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "backstage-community-plugin-tekton",
+                packageName: "@backstage-community/plugin-tekton",
+                dynamicArtifact: "oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-tekton:bs_1.45.3__3.33.3!backstage-community-plugin-tekton",
+            },
+            {
+                name: "backstage-community-plugin-tech-radar",
+                packageName: "@backstage-community/plugin-tech-radar",
+                dynamicArtifact: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+            },
+        ]);
+        try {
+            const config = {
+                plugins: [
+                    {
+                        package: "oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-tekton:old_tag!backstage-community-plugin-tekton",
+                        disabled: false,
+                    },
+                    {
+                        package: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                        disabled: false,
+                    },
+                    {
+                        package: "./dynamic-plugins/dist/backstage-community-plugin-catalog-backend-module-keycloak-dynamic",
+                        disabled: false,
+                    },
+                ],
+            };
+            const result = await processPluginsForDeployment(config, metadataDir);
+            const plugins = result.plugins;
+            assert.ok(plugins[0].package.includes("bs_1.45.3__3.33.3"), "OCI plugin with metadata must resolve to metadata dynamicArtifact");
+            assert.strictEqual(plugins[1].package, "./dynamic-plugins/dist/backstage-community-plugin-tech-radar", "local path plugin with metadata must stay unchanged");
+            assert.strictEqual(plugins[2].package, "./dynamic-plugins/dist/backstage-community-plugin-catalog-backend-module-keycloak-dynamic", "plugin without metadata must stay unchanged");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+    // ── PR vs nightly precedence ────────────────────────────────────────────
+    describe("PR vs nightly precedence", () => {
+        it("isNightlyJob returns false when both GIT_PR_NUMBER and E2E_NIGHTLY_MODE are set", () => {
+            process.env.GIT_PR_NUMBER = "42";
+            process.env.E2E_NIGHTLY_MODE = "true";
+            assert.strictEqual(isNightlyJob(), false, "GIT_PR_NUMBER must make isNightlyJob return false");
+        });
+        it("injects metadata config when GIT_PR_NUMBER is set (PR mode despite nightly env)", async () => {
+            process.env.GIT_PR_NUMBER = "42";
+            process.env.E2E_NIGHTLY_MODE = "true";
+            const { wsDir, metadataDir } = await createWorkspaceFixture([
+                {
+                    name: "backstage-community-plugin-tech-radar",
+                    packageName: "@backstage-community/plugin-tech-radar",
+                    dynamicArtifact: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                    appConfigExamples: {
+                        techRadar: { url: "http://default.example.com" },
+                    },
+                },
+            ]);
+            try {
+                const config = {
+                    plugins: [
+                        {
+                            package: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                            disabled: false,
+                        },
+                    ],
+                };
+                const result = await processPluginsForDeployment(config, metadataDir);
+                assert.ok(result.plugins[0].pluginConfig, "metadata injection must happen when GIT_PR_NUMBER is set (PR takes precedence over nightly)");
+            }
+            finally {
+                await fs.remove(wsDir);
+            }
+        });
+    });
+});

package/dist/utils/tests/plugin-metadata.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-metadata.test.d.ts","sourceRoot":"","sources":["../../../src/utils/tests/plugin-metadata.test.ts"],"names":[],"mappings":""}

package/dist/utils/tests/plugin-metadata.test.js

@@ -0,0 +1,156 @@
+/**
+ * Pure utility function tests — no env vars, no file system fixtures.
+ * Tests: extractPluginName, getNormalizedPluginMergeKey, disablePluginWrappers, generatePluginsFromMetadata
+ */
+import { describe, it } from "node:test";
+import assert from "node:assert";
+import fs from "fs-extra";
+import { extractPluginName, getNormalizedPluginMergeKey, disablePluginWrappers, generatePluginsFromMetadata, } from "../plugin-metadata.js";
+import { createMetadataFixture } from "./helpers.js";
+// ── extractPluginName ────────────────────────────────────────────────────────
+describe("extractPluginName", () => {
+    it("extracts name from OCI URL with tag and alias", () => {
+        assert.strictEqual(extractPluginName("oci://ghcr.io/org/repo/backstage-community-plugin-keycloak:pr_1__1.0!alias"), "backstage-community-plugin-keycloak");
+    });
+    it("extracts name from OCI URL with digest and alias", () => {
+        assert.strictEqual(extractPluginName("oci://quay.io/rhdh/backstage-plugin-events-backend-module-github@sha256:abc123!backstage-plugin-events-backend-module-github"), "backstage-plugin-events-backend-module-github");
+    });
+    it("extracts name from OCI URL with tag only (no alias)", () => {
+        assert.strictEqual(extractPluginName("oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-tekton:bs_1.45.3__3.33.3"), "backstage-community-plugin-tekton");
+    });
+    it("extracts name from local path", () => {
+        assert.strictEqual(extractPluginName("./dynamic-plugins/dist/backstage-community-plugin-keycloak-dynamic"), "backstage-community-plugin-keycloak-dynamic");
+    });
+    it("extracts name from OCI URL with digest but no alias", () => {
+        assert.strictEqual(extractPluginName("oci://quay.io/rhdh/backstage-plugin-events-backend-module-github@sha256:c1d17d47aaa"), "backstage-plugin-events-backend-module-github");
+    });
+    it("uses alias when alias differs from image name (redhat-resource-optimization pattern)", () => {
+        assert.strictEqual(extractPluginName("oci://quay.io/redhat-resource-optimization/dynamic-plugins:1.3.2!red-hat-developer-hub-plugin-redhat-resource-optimization"), "dynamic-plugins", "when alias is present, extractPluginName strips alias first and extracts from OCI path");
+    });
+    it("extracts name from npm package reference", () => {
+        assert.strictEqual(extractPluginName("@red-hat-developer-hub/backstage-plugin-global-header-test@0.0.2"), "backstage-plugin-global-header-test", "must extract plugin name from npm @scope/name@version format");
+    });
+});
+// ── getNormalizedPluginMergeKey ───────────────────────────────────────────────
+describe("getNormalizedPluginMergeKey", () => {
+    it("returns same key for OCI and local -dynamic variant of the same plugin", () => {
+        const oci = getNormalizedPluginMergeKey({
+            package: "oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-catalog-backend-module-keycloak:pr_1980__3.16.0!backstage-community-plugin-catalog-backend-module-keycloak",
+        });
+        const local = getNormalizedPluginMergeKey({
+            package: "./dynamic-plugins/dist/backstage-community-plugin-catalog-backend-module-keycloak-dynamic",
+        });
+        assert.strictEqual(oci, local, "same logical plugin has same merge key");
+        assert.strictEqual(oci, "backstage-community-plugin-catalog-backend-module-keycloak");
+    });
+    it("returns different keys for different plugins", () => {
+        const keycloak = getNormalizedPluginMergeKey({
+            package: "./dynamic-plugins/dist/backstage-community-plugin-catalog-backend-module-keycloak-dynamic",
+        });
+        const techRadar = getNormalizedPluginMergeKey({
+            package: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar-dynamic",
+        });
+        assert.notStrictEqual(keycloak, techRadar);
+    });
+    it("returns empty string for missing or empty package", () => {
+        assert.strictEqual(getNormalizedPluginMergeKey({}), "");
+        assert.strictEqual(getNormalizedPluginMergeKey({ package: "" }), "");
+        assert.strictEqual(getNormalizedPluginMergeKey({ package: undefined }), "");
+    });
+});
+// ── disablePluginWrappers ────────────────────────────────────────────────────
+describe("disablePluginWrappers", () => {
+    it("returns empty plugins array for empty input", () => {
+        const result = disablePluginWrappers([]);
+        assert.deepStrictEqual(result, { plugins: [] });
+    });
+    it("creates disabled entries with correct local path format", () => {
+        const result = disablePluginWrappers([
+            "backstage-community-plugin-tech-radar",
+            "backstage-plugin-kubernetes",
+        ]);
+        assert.strictEqual(result.plugins.length, 2);
+        assert.deepStrictEqual(result.plugins[0], {
+            package: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+            disabled: true,
+        });
+        assert.deepStrictEqual(result.plugins[1], {
+            package: "./dynamic-plugins/dist/backstage-plugin-kubernetes",
+            disabled: true,
+        });
+    });
+});
+// ── generatePluginsFromMetadata ──────────────────────────────────────────────
+describe("generatePluginsFromMetadata", () => {
+    it("generates entries from metadata with package set to dynamicArtifact", async () => {
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "backstage-community-plugin-tech-radar",
+                packageName: "@backstage-community/plugin-tech-radar",
+                dynamicArtifact: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+                appConfigExamples: { techRadar: { url: "http://example.com" } },
+            },
+        ]);
+        try {
+            const result = await generatePluginsFromMetadata(metadataDir);
+            assert.strictEqual(result.plugins.length, 1);
+            assert.strictEqual(result.plugins[0].package, "./dynamic-plugins/dist/backstage-community-plugin-tech-radar", "package must be the dynamicArtifact from metadata");
+            assert.strictEqual(result.plugins[0].disabled, false);
+            assert.strictEqual(result.plugins[0].pluginConfig, undefined, "generatePluginsFromMetadata must NOT include pluginConfig");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+    it("generates entries for OCI-referenced plugins", async () => {
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "backstage-community-plugin-tekton",
+                packageName: "@backstage-community/plugin-tekton",
+                dynamicArtifact: "oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-tekton:bs_1.45.3__3.33.3!backstage-community-plugin-tekton",
+            },
+        ]);
+        try {
+            const result = await generatePluginsFromMetadata(metadataDir);
+            assert.strictEqual(result.plugins.length, 1);
+            assert.ok(result.plugins[0].package.startsWith("oci://"), "OCI artifact must be preserved as package");
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+    it("generates entries for mixed local and OCI artifacts", async () => {
+        const metadataDir = await createMetadataFixture([
+            {
+                name: "backstage-community-plugin-tech-radar",
+                packageName: "@backstage-community/plugin-tech-radar",
+                dynamicArtifact: "./dynamic-plugins/dist/backstage-community-plugin-tech-radar",
+            },
+            {
+                name: "backstage-community-plugin-tekton",
+                packageName: "@backstage-community/plugin-tekton",
+                dynamicArtifact: "oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-tekton:bs_1.45.3__3.33.3!backstage-community-plugin-tekton",
+            },
+            {
+                name: "backstage-plugin-events-backend-module-github",
+                packageName: "@backstage/plugin-events-backend-module-github",
+                dynamicArtifact: "oci://quay.io/rhdh/backstage-plugin-events-backend-module-github@sha256:abc123",
+            },
+        ]);
+        try {
+            const result = await generatePluginsFromMetadata(metadataDir);
+            assert.strictEqual(result.plugins.length, 3, "must generate 3 entries");
+            const packages = result.plugins.map((p) => p.package).sort();
+            assert.ok(packages.some((p) => p.startsWith("./")), "must include local path artifact");
+            assert.ok(packages.some((p) => p.startsWith("oci://ghcr.io/")), "must include ghcr.io OCI");
+            assert.ok(packages.some((p) => p.startsWith("oci://quay.io/")), "must include quay.io OCI");
+            for (const plugin of result.plugins) {
+                assert.strictEqual(plugin.disabled, false);
+                assert.strictEqual(plugin.pluginConfig, undefined);
+            }
+        }
+        finally {
+            await fs.remove(metadataDir);
+        }
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@red-hat-developer-hub/e2e-test-utils",
-  "version": "1.1.24",
+  "version": "1.1.26",
   "description": "Test utilities for RHDH E2E tests",
   "license": "Apache-2.0",
   "repository": {

package/dist/utils/plugin-metadata.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-metadata.test.d.ts","sourceRoot":"","sources":["../../src/utils/plugin-metadata.test.ts"],"names":[],"mappings":""}