@elisra-devops/docgen-data-provider 1.69.0 → 1.69.2

package/bin/modules/PipelinesDataProvider.d.ts

@@ -1,8 +1,9 @@
-import { PipelineRun } from '../models/tfs-data';
+import { PipelineRun, ResourceRepository } from '../models/tfs-data';
 import GitDataProvider from './GitDataProvider';
 export default class PipelinesDataProvider {
     orgUrl: string;
     token: string;
+    private projectNameByIdCache;
     constructor(orgUrl: string, token: string);
     findPreviousPipeline(teamProject: string, pipelineId: string, toPipelineRunId: number, targetPipeline: any, searchPrevPipelineFromDifferentCommit: boolean, fromStage?: string): Promise<any>;
     /**
@@ -32,32 +33,113 @@ export default class PipelinesDataProvider {
      * @returns `true` if the pipelines match based on the repository and version criteria; otherwise, `false`.
      */
     private isMatchingPipeline;
+    private tryGetTeamProjectFromAzureDevOpsUrl;
     /**
-     * Retrieves a set of pipeline resources from a given pipeline run object.
+     * Returns `true` when the input looks like an Azure DevOps GUID identifier.
+     */
+    private isGuidLike;
+    /**
+     * Normalizes a project identifier into a project name suitable for `{project}` URL path segments.
+     *
+     * Azure DevOps APIs often accept both project names and IDs, but some endpoints (especially on ADO Server)
+     * behave differently or return empty results when a GUID is used in the URL path. This method converts
+     * a GUID into its canonical project name via `/_apis/projects/{id}` and caches the mapping.
+     *
+     * @param projectNameOrId Project name (e.g. "Test CMMI") or project GUID.
+     * @returns The project name, or the original input when resolution fails.
+     */
+    private normalizeProjectName;
+    /**
+     * Attempts to extract a run/build id from an Azure DevOps URL.
+     *
+     * Supports URLs shaped like:
+     * - `.../_apis/pipelines/{pipelineId}/runs/{runId}`
+     * - `.../_apis/build/builds/{buildId}`
+     */
+    private tryParseRunIdFromUrl;
+    /**
+     * Normalizes a branch name into a `refs/...` form accepted by the Builds API.
+     */
+    private normalizeBranchName;
+    /**
+     * Searches for a build by build number without restricting by definition id.
+     *
+     * Used as a fallback when the `resources.pipelines[alias].pipeline.id` is not a stable build definition id
+     * (some ADO instances return a run/build id or a pipeline revision-related id instead).
+     *
+     * @param projectName Team project name.
+     * @param buildNumber Build number / run name (e.g. "20251225.2", "1.0.56").
+     * @param branch Optional branch filter.
+     * @param expectedDefinitionName Optional build definition name to disambiguate results (typically YAML `source`).
+     */
+    private findBuildByBuildNumber;
+    /**
+     * Retrieves a build by id, with an additional fallback for ADO instances that allow the non-project-scoped route.
+     *
+     * @param projectName Optional team project name.
+     * @param buildId Build id.
+     */
+    private tryGetBuildByIdWithFallback;
+    /**
+     * Searches for a build by definition id + build number.
+     *
+     * @param projectName Team project name.
+     * @param definitionId Build definition id (classic build definition id).
+     * @param buildNumber Build number / run name.
+     * @param branch Optional branch filter.
+     */
+    private findBuildByDefinitionAndBuildNumber;
+    /**
+     * Resolves a pipelines API run id by comparing a desired run name against the pipeline run history.
+     *
+     * Useful when Builds API lookups don't return results even though the upstream run exists.
+     *
+     * @param projectName Team project name.
+     * @param pipelineId Pipeline id.
+     * @param runName Run "name" from ADO UI (e.g. "20251225.2").
+     */
+    private findRunIdByPipelineRunName;
+    /**
+     * Attempts to infer a run/build id for a pipeline resource from the run payload fields.
+     *
+     * Resolution order:
+     * 1) `resource.runId` (preferred)
+     * 2) numeric `resource.version` (only if it's an integer string/number)
+     * 3) parse from `resource.pipeline.url` if it contains `/runs/{id}` or `/builds/{id}`
+     */
+    private inferRunIdFromPipelineResource;
+    /**
+     * Resolves a pipeline resource run id from a non-numeric `version` (run name/build number).
+     *
+     * Fall back order (when `runId` isn't present):
+     * 1) Builds API: definitionId + buildNumber
+     * 2) Builds API: buildNumber-only (optionally filtered by YAML `source`)
+     * 3) Pipelines API: run history match by `name` / `#name`
+     * 4) Heuristic: treat `pipelineIdCandidate` as buildId and fetch that build
+     */
+    private resolveRunIdFromVersion;
+    private isSupportedResourcePipelineBuild;
+    /**
+     * Extracts and resolves pipeline resources (`resources.pipelines`) from a pipeline run.
      *
-     * @param inPipeline - The pipeline run object containing resources.
-     * @returns A promise that resolves to an array of unique pipeline resource objects.
+     * Azure DevOps represents pipeline dependencies as "pipeline resources". Those resources do not always include
+     * a concrete `runId`, so this method resolves them into build-backed objects that can be used for recursion
+     * (e.g., release notes / SVD traversal).
      *
-     * The function performs the following steps:
-     * 1. Initializes an empty set to store unique pipeline resources.
-     * 2. Checks if the input pipeline has any resources of type pipelines.
-     * 3. Iterates over each pipeline resource and processes it.
-     * 4. Fixes the URL of the pipeline resource to match the build API format.
-     * 5. Fetches the build details using the fixed URL.
-     * 6. If the build response is valid and matches the criteria, adds the pipeline resource to the set.
-     * 7. Returns an array of unique pipeline resources.
+     * @param inPipeline Pipeline run payload that contains `resources.pipelines`.
+     * @returns A collection of normalized pipeline resource objects (array), or an empty Set when there are no resources.
      *
-     * The returned pipeline resource object contains the following properties:
-     * - name: The alias name of the resource pipeline.
-     * - buildId: The ID of the resource pipeline.
-     * - definitionId: The ID of the build definition.
-     * - buildNumber: The build number.
-     * - teamProject: The name of the team project.
-     * - provider: The type of repository provider.
+     * Complexity: O(p) for p pipeline resources (network I/O dominates).
      *
-     * @throws Will log an error message if there is an issue fetching the pipeline resource.
+     * Returned object shape:
+     * - `name`: resource alias
+     * - `buildId`: resolved build/run id
+     * - `definitionId`: build definition id (classic build definition id)
+     * - `buildNumber`: build number / run name
+     * - `teamProject`: resolved project name
+     * - `provider`: repo provider type (e.g., `TfsGit`)
      */
-    getPipelineResourcePipelinesFromObject(inPipeline: PipelineRun): Promise<any[] | Set<any>>;
+    getPipelineResourcePipelinesFromObject(inPipeline: PipelineRun): Promise<any[] | Set<unknown>>;
     /**
      * Retrieves a set of resource repositories from a given pipeline object.
      *
@@ -65,7 +147,7 @@ export default class PipelinesDataProvider {
      * @param gitDataProviderInstance - An instance of GitDataProvider to fetch repository details.
      * @returns A promise that resolves to an array of unique resource repositories.
      */
-    getPipelineResourceRepositoriesFromObject(inPipeline: PipelineRun, gitDataProviderInstance: GitDataProvider): Promise<any[] | Map<number, any>>;
+    getPipelineResourceRepositoriesFromObject(inPipeline: PipelineRun, gitDataProviderInstance: GitDataProvider): Promise<ResourceRepository[]>;
     /**
      * Retrieves the details of a specific pipeline build by its build ID.
      *

package/bin/modules/PipelinesDataProvider.js

@@ -6,10 +6,12 @@ class PipelinesDataProvider {
     constructor(orgUrl, token) {
         this.orgUrl = '';
         this.token = '';
+        this.projectNameByIdCache = new Map();
         this.orgUrl = orgUrl;
         this.token = token;
     }
     async findPreviousPipeline(teamProject, pipelineId, toPipelineRunId, targetPipeline, searchPrevPipelineFromDifferentCommit, fromStage = '') {
+        var _a;
         const pipelineRuns = await this.GetPipelineRunHistory(teamProject, pipelineId);
         if (!pipelineRuns.value) {
             return undefined;
@@ -22,7 +24,7 @@ class PipelinesDataProvider {
                 continue;
             }
             const fromPipeline = await this.getPipelineRunDetails(teamProject, Number(pipelineId), pipelineRun.id);
-            if (!fromPipeline.resources.repositories) {
+            if (!((_a = fromPipeline === null || fromPipeline === void 0 ? void 0 : fromPipeline.resources) === null || _a === void 0 ? void 0 : _a.repositories)) {
                 continue;
             }
             if (this.isMatchingPipeline(fromPipeline, targetPipeline, searchPrevPipelineFromDifferentCommit)) {
@@ -66,9 +68,15 @@ class PipelinesDataProvider {
      * @returns `true` if the pipelines match based on the repository and version criteria; otherwise, `false`.
      */
     isMatchingPipeline(fromPipeline, targetPipeline, searchPrevPipelineFromDifferentCommit) {
-        var _a, _b;
-        const fromRepo = ((_a = fromPipeline.resources.repositories[0]) === null || _a === void 0 ? void 0 : _a.self) || fromPipeline.resources.repositories.__designer_repo;
-        const targetRepo = ((_b = targetPipeline.resources.repositories[0]) === null || _b === void 0 ? void 0 : _b.self) || targetPipeline.resources.repositories.__designer_repo;
+        var _a, _b, _c, _d, _e, _f;
+        if (!((_a = fromPipeline === null || fromPipeline === void 0 ? void 0 : fromPipeline.resources) === null || _a === void 0 ? void 0 : _a.repositories) || !((_b = targetPipeline === null || targetPipeline === void 0 ? void 0 : targetPipeline.resources) === null || _b === void 0 ? void 0 : _b.repositories)) {
+            return false;
+        }
+        const fromRepo = ((_c = fromPipeline.resources.repositories[0]) === null || _c === void 0 ? void 0 : _c.self) || fromPipeline.resources.repositories.__designer_repo;
+        const targetRepo = ((_d = targetPipeline.resources.repositories[0]) === null || _d === void 0 ? void 0 : _d.self) || targetPipeline.resources.repositories.__designer_repo;
+        if (!((_e = fromRepo === null || fromRepo === void 0 ? void 0 : fromRepo.repository) === null || _e === void 0 ? void 0 : _e.id) || !((_f = targetRepo === null || targetRepo === void 0 ? void 0 : targetRepo.repository) === null || _f === void 0 ? void 0 : _f.id)) {
+            return false;
+        }
         if (fromRepo.repository.id !== targetRepo.repository.id) {
             return false;
         }
@@ -77,68 +85,362 @@ class PipelinesDataProvider {
         }
         return fromRepo.refName === targetRepo.refName;
     }
+    tryGetTeamProjectFromAzureDevOpsUrl(url) {
+        if (!url)
+            return undefined;
+        try {
+            const parsed = new URL(url);
+            const parts = parsed.pathname.split('/').filter(Boolean);
+            const apiIndex = parts.findIndex((p) => p === '_apis');
+            if (apiIndex <= 0)
+                return undefined;
+            return parts[apiIndex - 1];
+        }
+        catch (_a) {
+            return undefined;
+        }
+    }
+    /**
+     * Returns `true` when the input looks like an Azure DevOps GUID identifier.
+     */
+    isGuidLike(value) {
+        if (!value)
+            return false;
+        return /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.test(String(value).trim());
+    }
+    /**
+     * Normalizes a project identifier into a project name suitable for `{project}` URL path segments.
+     *
+     * Azure DevOps APIs often accept both project names and IDs, but some endpoints (especially on ADO Server)
+     * behave differently or return empty results when a GUID is used in the URL path. This method converts
+     * a GUID into its canonical project name via `/_apis/projects/{id}` and caches the mapping.
+     *
+     * @param projectNameOrId Project name (e.g. "Test CMMI") or project GUID.
+     * @returns The project name, or the original input when resolution fails.
+     */
+    async normalizeProjectName(projectNameOrId) {
+        if (!projectNameOrId)
+            return undefined;
+        const raw = String(projectNameOrId).trim();
+        if (!raw)
+            return undefined;
+        if (!this.isGuidLike(raw))
+            return raw;
+        const cached = this.projectNameByIdCache.get(raw);
+        if (cached)
+            return cached;
+        // ADO supports querying projects at the collection/org root.
+        const url = `${this.orgUrl}_apis/projects/${encodeURIComponent(raw)}?api-version=6.0`;
+        try {
+            const project = await tfs_1.TFSServices.getItemContent(url, this.token, 'get', null, null, false);
+            const resolvedName = String((project === null || project === void 0 ? void 0 : project.name) || '').trim();
+            if (resolvedName) {
+                this.projectNameByIdCache.set(raw, resolvedName);
+                return resolvedName;
+            }
+            return raw;
+        }
+        catch (err) {
+            return raw;
+        }
+    }
+    /**
+     * Attempts to extract a run/build id from an Azure DevOps URL.
+     *
+     * Supports URLs shaped like:
+     * - `.../_apis/pipelines/{pipelineId}/runs/{runId}`
+     * - `.../_apis/build/builds/{buildId}`
+     */
+    tryParseRunIdFromUrl(url) {
+        if (!url)
+            return undefined;
+        try {
+            const parsed = new URL(url);
+            const parts = parsed.pathname.split('/').filter(Boolean);
+            const runsIndex = parts.findIndex((p) => p === 'runs');
+            if (runsIndex >= 0 && parts[runsIndex + 1]) {
+                const runId = Number(parts[runsIndex + 1]);
+                return Number.isFinite(runId) ? runId : undefined;
+            }
+            const buildsIndex = parts.findIndex((p) => p === 'builds');
+            if (buildsIndex >= 0 && parts[buildsIndex + 1]) {
+                const buildId = Number(parts[buildsIndex + 1]);
+                return Number.isFinite(buildId) ? buildId : undefined;
+            }
+            return undefined;
+        }
+        catch (_a) {
+            return undefined;
+        }
+    }
+    /**
+     * Normalizes a branch name into a `refs/...` form accepted by the Builds API.
+     */
+    normalizeBranchName(branch) {
+        if (!branch)
+            return undefined;
+        const b = String(branch).trim();
+        if (!b)
+            return undefined;
+        if (b.startsWith('refs/'))
+            return b;
+        if (b.startsWith('heads/'))
+            return `refs/${b}`;
+        return `refs/heads/${b}`;
+    }
+    /**
+     * Searches for a build by build number without restricting by definition id.
+     *
+     * Used as a fallback when the `resources.pipelines[alias].pipeline.id` is not a stable build definition id
+     * (some ADO instances return a run/build id or a pipeline revision-related id instead).
+     *
+     * @param projectName Team project name.
+     * @param buildNumber Build number / run name (e.g. "20251225.2", "1.0.56").
+     * @param branch Optional branch filter.
+     * @param expectedDefinitionName Optional build definition name to disambiguate results (typically YAML `source`).
+     */
+    async findBuildByBuildNumber(projectName, buildNumber, branch, expectedDefinitionName) {
+        var _a;
+        const bn = String(buildNumber || '').trim();
+        if (!bn)
+            return undefined;
+        const normalizedBranch = this.normalizeBranchName(branch);
+        let url = `${this.orgUrl}${projectName}/_apis/build/builds?buildNumber=${encodeURIComponent(bn)}&$top=20&queryOrder=finishTimeDescending&api-version=6.0`;
+        if (normalizedBranch) {
+            url += `&branchName=${encodeURIComponent(normalizedBranch)}`;
+        }
+        try {
+            const res = await tfs_1.TFSServices.getItemContent(url, this.token, 'get', null, null);
+            const value = (res === null || res === void 0 ? void 0 : res.value) || [];
+            const filtered = expectedDefinitionName
+                ? value.filter((b) => { var _a; return String(((_a = b === null || b === void 0 ? void 0 : b.definition) === null || _a === void 0 ? void 0 : _a.name) || '') === String(expectedDefinitionName); })
+                : value;
+            return (_a = filtered[0]) !== null && _a !== void 0 ? _a : value[0];
+        }
+        catch (err) {
+            logger_1.default.error(`Error resolving build by buildNumber (no definition) (${projectName}/${bn}): ${(err === null || err === void 0 ? void 0 : err.message) || err}`);
+            return undefined;
+        }
+    }
     /**
-     * Retrieves a set of pipeline resources from a given pipeline run object.
+     * Retrieves a build by id, with an additional fallback for ADO instances that allow the non-project-scoped route.
      *
-     * @param inPipeline - The pipeline run object containing resources.
-     * @returns A promise that resolves to an array of unique pipeline resource objects.
+     * @param projectName Optional team project name.
+     * @param buildId Build id.
+     */
+    async tryGetBuildByIdWithFallback(projectName, buildId) {
+        if (projectName) {
+            try {
+                return await this.getPipelineBuildByBuildId(projectName, buildId);
+            }
+            catch (e1) {
+            }
+        }
+        // Some ADO instances allow build lookup without the {project} path segment.
+        try {
+            const url = `${this.orgUrl}_apis/build/builds/${buildId}`;
+            return await tfs_1.TFSServices.getItemContent(url, this.token, 'get', null, null);
+        }
+        catch (e2) {
+            return undefined;
+        }
+    }
+    /**
+     * Searches for a build by definition id + build number.
      *
-     * The function performs the following steps:
-     * 1. Initializes an empty set to store unique pipeline resources.
-     * 2. Checks if the input pipeline has any resources of type pipelines.
-     * 3. Iterates over each pipeline resource and processes it.
-     * 4. Fixes the URL of the pipeline resource to match the build API format.
-     * 5. Fetches the build details using the fixed URL.
-     * 6. If the build response is valid and matches the criteria, adds the pipeline resource to the set.
-     * 7. Returns an array of unique pipeline resources.
+     * @param projectName Team project name.
+     * @param definitionId Build definition id (classic build definition id).
+     * @param buildNumber Build number / run name.
+     * @param branch Optional branch filter.
+     */
+    async findBuildByDefinitionAndBuildNumber(projectName, definitionId, buildNumber, branch) {
+        const bn = String(buildNumber || '').trim();
+        if (!bn)
+            return undefined;
+        const normalizedBranch = this.normalizeBranchName(branch);
+        let url = `${this.orgUrl}${projectName}/_apis/build/builds?definitions=${encodeURIComponent(String(definitionId))}&buildNumber=${encodeURIComponent(bn)}&$top=1&queryOrder=finishTimeDescending&api-version=6.0`;
+        if (normalizedBranch) {
+            url += `&branchName=${encodeURIComponent(normalizedBranch)}`;
+        }
+        try {
+            const res = await tfs_1.TFSServices.getItemContent(url, this.token, 'get', null, null);
+            const value = (res === null || res === void 0 ? void 0 : res.value) || [];
+            return value[0];
+        }
+        catch (err) {
+            logger_1.default.error(`Error resolving build by buildNumber for definition ${definitionId} (${projectName}/${bn}): ${err.message}`);
+            return undefined;
+        }
+    }
+    /**
+     * Resolves a pipelines API run id by comparing a desired run name against the pipeline run history.
      *
-     * The returned pipeline resource object contains the following properties:
-     * - name: The alias name of the resource pipeline.
-     * - buildId: The ID of the resource pipeline.
-     * - definitionId: The ID of the build definition.
-     * - buildNumber: The build number.
-     * - teamProject: The name of the team project.
-     * - provider: The type of repository provider.
+     * Useful when Builds API lookups don't return results even though the upstream run exists.
      *
-     * @throws Will log an error message if there is an issue fetching the pipeline resource.
+     * @param projectName Team project name.
+     * @param pipelineId Pipeline id.
+     * @param runName Run "name" from ADO UI (e.g. "20251225.2").
+     */
+    async findRunIdByPipelineRunName(projectName, pipelineId, runName) {
+        const desired = String(runName || '').trim();
+        if (!desired)
+            return undefined;
+        try {
+            const history = await this.GetPipelineRunHistory(projectName, String(pipelineId));
+            const runs = (history === null || history === void 0 ? void 0 : history.value) || [];
+            const match = runs.find((r) => {
+                const name = String((r === null || r === void 0 ? void 0 : r.name) || '').trim();
+                const id = String((r === null || r === void 0 ? void 0 : r.id) || '').trim();
+                return name === desired || name === `#${desired}` || id === desired;
+            });
+            if (match === null || match === void 0 ? void 0 : match.id) {
+                return Number(match.id);
+            }
+            return undefined;
+        }
+        catch (e) {
+            logger_1.default.error(`Error resolving runId by runName for pipeline ${pipelineId} (${projectName}/${desired}): ${(e === null || e === void 0 ? void 0 : e.message) || e}`);
+            return undefined;
+        }
+    }
+    /**
+     * Attempts to infer a run/build id for a pipeline resource from the run payload fields.
+     *
+     * Resolution order:
+     * 1) `resource.runId` (preferred)
+     * 2) numeric `resource.version` (only if it's an integer string/number)
+     * 3) parse from `resource.pipeline.url` if it contains `/runs/{id}` or `/builds/{id}`
+     */
+    inferRunIdFromPipelineResource(resource, pipelineUrl) {
+        const explicit = Number(resource === null || resource === void 0 ? void 0 : resource.runId);
+        if (Number.isFinite(explicit))
+            return explicit;
+        const version = resource === null || resource === void 0 ? void 0 : resource.version;
+        if (typeof version === 'number' && Number.isFinite(version))
+            return version;
+        if (typeof version === 'string' && /^\d+$/.test(version))
+            return Number(version);
+        const parsed = this.tryParseRunIdFromUrl(pipelineUrl);
+        return Number.isFinite(parsed) ? Number(parsed) : undefined;
+    }
+    /**
+     * Resolves a pipeline resource run id from a non-numeric `version` (run name/build number).
+     *
+     * Fall back order (when `runId` isn't present):
+     * 1) Builds API: definitionId + buildNumber
+     * 2) Builds API: buildNumber-only (optionally filtered by YAML `source`)
+     * 3) Pipelines API: run history match by `name` / `#name`
+     * 4) Heuristic: treat `pipelineIdCandidate` as buildId and fetch that build
+     */
+    async resolveRunIdFromVersion(params) {
+        const { projectName, pipelineIdCandidate, version, branch, source } = params;
+        if (!Number.isFinite(pipelineIdCandidate))
+            return undefined;
+        if (!projectName) {
+            const buildById = await this.tryGetBuildByIdWithFallback(undefined, pipelineIdCandidate);
+            return (buildById === null || buildById === void 0 ? void 0 : buildById.id) ? Number(buildById.id) : undefined;
+        }
+        if (typeof version !== 'string' || !String(version).trim())
+            return undefined;
+        const buildNumber = String(version).trim();
+        const buildByNumber = await this.findBuildByDefinitionAndBuildNumber(projectName, pipelineIdCandidate, buildNumber, branch);
+        if (buildByNumber === null || buildByNumber === void 0 ? void 0 : buildByNumber.id)
+            return Number(buildByNumber.id);
+        const buildByNumberAny = await this.findBuildByBuildNumber(projectName, buildNumber, branch, typeof source === 'string' ? source : undefined);
+        if (buildByNumberAny === null || buildByNumberAny === void 0 ? void 0 : buildByNumberAny.id)
+            return Number(buildByNumberAny.id);
+        const runIdByName = await this.findRunIdByPipelineRunName(projectName, pipelineIdCandidate, buildNumber);
+        if (runIdByName)
+            return runIdByName;
+        const buildById = await this.tryGetBuildByIdWithFallback(projectName, pipelineIdCandidate);
+        return (buildById === null || buildById === void 0 ? void 0 : buildById.id) ? Number(buildById.id) : undefined;
+    }
+    isSupportedResourcePipelineBuild(buildResponse) {
+        var _a, _b;
+        const definitionType = (_a = buildResponse === null || buildResponse === void 0 ? void 0 : buildResponse.definition) === null || _a === void 0 ? void 0 : _a.type;
+        const repoType = (_b = buildResponse === null || buildResponse === void 0 ? void 0 : buildResponse.repository) === null || _b === void 0 ? void 0 : _b.type;
+        return (!!buildResponse &&
+            definitionType === 'build' &&
+            (repoType === 'TfsGit' || repoType === 'azureReposGit'));
+    }
+    /**
+     * Extracts and resolves pipeline resources (`resources.pipelines`) from a pipeline run.
+     *
+     * Azure DevOps represents pipeline dependencies as "pipeline resources". Those resources do not always include
+     * a concrete `runId`, so this method resolves them into build-backed objects that can be used for recursion
+     * (e.g., release notes / SVD traversal).
+     *
+     * @param inPipeline Pipeline run payload that contains `resources.pipelines`.
+     * @returns A collection of normalized pipeline resource objects (array), or an empty Set when there are no resources.
+     *
+     * Complexity: O(p) for p pipeline resources (network I/O dominates).
+     *
+     * Returned object shape:
+     * - `name`: resource alias
+     * - `buildId`: resolved build/run id
+     * - `definitionId`: build definition id (classic build definition id)
+     * - `buildNumber`: build number / run name
+     * - `teamProject`: resolved project name
+     * - `provider`: repo provider type (e.g., `TfsGit`)
      */
     async getPipelineResourcePipelinesFromObject(inPipeline) {
-        const resourcePipelines = new Set();
-        if (!inPipeline.resources.pipelines) {
-            return resourcePipelines;
+        var _a;
+        const resourcePipelinesByKey = new Map();
+        if (!((_a = inPipeline === null || inPipeline === void 0 ? void 0 : inPipeline.resources) === null || _a === void 0 ? void 0 : _a.pipelines)) {
+            return new Set();
         }
-        const pipelines = inPipeline.resources.pipelines;
-        const pipelineEntries = Object.entries(pipelines);
+        const pipelineEntries = Object.entries(inPipeline.resources.pipelines);
         await Promise.all(pipelineEntries.map(async ([resourcePipelineAlias, resource]) => {
-            const resourcePipelineObj = resource.pipeline;
-            const resourcePipelineName = resourcePipelineAlias;
-            let urlBeforeFix = resourcePipelineObj.url;
-            urlBeforeFix = urlBeforeFix.substring(0, urlBeforeFix.indexOf('?revision'));
-            const fixedUrl = urlBeforeFix.replace('/_apis/pipelines/', '/_apis/build/builds/');
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const resourcePipelineObj = resource === null || resource === void 0 ? void 0 : resource.pipeline;
+            const pipelineIdCandidate = Number(resourcePipelineObj === null || resourcePipelineObj === void 0 ? void 0 : resourcePipelineObj.id);
+            const source = resource === null || resource === void 0 ? void 0 : resource.source;
+            const version = resource === null || resource === void 0 ? void 0 : resource.version;
+            const branch = resource === null || resource === void 0 ? void 0 : resource.branch;
+            const rawProjectName = ((_a = resource === null || resource === void 0 ? void 0 : resource.project) === null || _a === void 0 ? void 0 : _a.name) ||
+                this.tryGetTeamProjectFromAzureDevOpsUrl(resourcePipelineObj === null || resourcePipelineObj === void 0 ? void 0 : resourcePipelineObj.url) ||
+                this.tryGetTeamProjectFromAzureDevOpsUrl(inPipeline === null || inPipeline === void 0 ? void 0 : inPipeline.url);
+            const projectName = await this.normalizeProjectName(rawProjectName);
+            if (!Number.isFinite(pipelineIdCandidate)) {
+                return;
+            }
+            let runId = this.inferRunIdFromPipelineResource(resource, resourcePipelineObj === null || resourcePipelineObj === void 0 ? void 0 : resourcePipelineObj.url);
+            if (typeof runId !== 'number' || !Number.isFinite(runId)) {
+                runId = await this.resolveRunIdFromVersion({
+                    projectName,
+                    pipelineIdCandidate,
+                    version,
+                    branch,
+                    source,
+                });
+            }
+            if (typeof runId !== 'number' || !Number.isFinite(runId)) {
+                return;
+            }
             let buildResponse;
             try {
-                buildResponse = await tfs_1.TFSServices.getItemContent(fixedUrl, this.token, 'get');
+                buildResponse = await this.tryGetBuildByIdWithFallback(projectName, runId);
             }
             catch (err) {
-                logger_1.default.error(`Error fetching pipeline ${resourcePipelineName} : ${err.message}`);
+                logger_1.default.error(`Error fetching pipeline ${resourcePipelineAlias} run ${runId} : ${err.message}`);
             }
-            if (buildResponse &&
-                buildResponse.definition.type === 'build' &&
-                buildResponse.repository.type === 'TfsGit') {
-                let resourcePipelineToAdd = {
-                    name: resourcePipelineName,
-                    buildId: resourcePipelineObj.id,
-                    definitionId: buildResponse.definition.id,
-                    buildNumber: buildResponse.buildNumber,
-                    teamProject: buildResponse.project.name,
-                    provider: buildResponse.repository.type,
+            if (this.isSupportedResourcePipelineBuild(buildResponse)) {
+                const definitionId = (_c = (_b = buildResponse.definition) === null || _b === void 0 ? void 0 : _b.id) !== null && _c !== void 0 ? _c : pipelineIdCandidate;
+                const buildId = (_d = buildResponse.id) !== null && _d !== void 0 ? _d : runId;
+                const resourcePipelineToAdd = {
+                    name: resourcePipelineAlias,
+                    buildId,
+                    definitionId,
+                    buildNumber: (_f = (_e = buildResponse.buildNumber) !== null && _e !== void 0 ? _e : resource === null || resource === void 0 ? void 0 : resource.runName) !== null && _f !== void 0 ? _f : resource === null || resource === void 0 ? void 0 : resource.version,
+                    teamProject: (_h = (_g = buildResponse.project) === null || _g === void 0 ? void 0 : _g.name) !== null && _h !== void 0 ? _h : projectName,
+                    provider: (_j = buildResponse.repository) === null || _j === void 0 ? void 0 : _j.type,
                 };
-                if (!resourcePipelines.has(resourcePipelineToAdd)) {
-                    resourcePipelines.add(resourcePipelineToAdd);
-                }
+                const key = `${resourcePipelineToAdd.teamProject}:${resourcePipelineToAdd.definitionId}:${resourcePipelineToAdd.buildId}:${resourcePipelineToAdd.name}`;
+                if (!resourcePipelinesByKey.has(key))
+                    resourcePipelinesByKey.set(key, resourcePipelineToAdd);
             }
         }));
-        return [...resourcePipelines];
+        return [...resourcePipelinesByKey.values()];
     }
     /**
      * Retrieves a set of resource repositories from a given pipeline object.
@@ -148,28 +450,32 @@ class PipelinesDataProvider {
      * @returns A promise that resolves to an array of unique resource repositories.
      */
     async getPipelineResourceRepositoriesFromObject(inPipeline, gitDataProviderInstance) {
-        const resourceRepositories = new Map();
-        if (!inPipeline.resources.repositories) {
-            return resourceRepositories;
+        var _a, _b;
+        const resourceRepositoriesById = new Map();
+        const repositories = (_a = inPipeline === null || inPipeline === void 0 ? void 0 : inPipeline.resources) === null || _a === void 0 ? void 0 : _a.repositories;
+        if (!repositories) {
+            return [];
         }
-        const repositories = inPipeline.resources.repositories;
         for (const prop in repositories) {
             const resourceRepo = repositories[prop];
-            if (resourceRepo.repository.type !== 'azureReposGit') {
+            if (((_b = resourceRepo === null || resourceRepo === void 0 ? void 0 : resourceRepo.repository) === null || _b === void 0 ? void 0 : _b.type) !== 'azureReposGit') {
                 continue;
             }
             const repoId = resourceRepo.repository.id;
+            if (!repoId)
+                continue;
             const repo = await gitDataProviderInstance.GetGitRepoFromRepoId(repoId);
             const resourceRepository = {
                 repoName: repo.name,
                 repoSha1: resourceRepo.version,
                 url: repo.url,
             };
-            if (!resourceRepositories.has(Number(repoId))) {
-                resourceRepositories.set(Number(repoId), resourceRepository);
+            const key = String(repoId);
+            if (!resourceRepositoriesById.has(key)) {
+                resourceRepositoriesById.set(key, resourceRepository);
             }
         }
-        return [...resourceRepositories.values()];
+        return [...resourceRepositoriesById.values()];
     }
     /**
      * Retrieves the details of a specific pipeline build by its build ID.
@@ -269,7 +575,7 @@ class PipelinesDataProvider {
             //Filter successful builds only
             let { value } = res;
             if (value) {
-                const successfulRunHistory = value.filter((run) => run.result !== 'failed' || run.result !== 'canceled');
+                const successfulRunHistory = value.filter((run) => run.result !== 'failed' && run.result !== 'canceled');
                 return { count: successfulRunHistory.length, value: successfulRunHistory };
             }
             return res;