Fixing deploy udr workflow (#1302)

Please go to the `Preview` tab and select the appropriate template:

* [HCP services](?expand=1&template=hcp_pull_request_template.md)
* [Terraform
Enterprise](?expand=1&template=ptfe_release_pull_request_template.md)

Adding in fix re [this slack support
ticket](https://ibm-hashicorp.slack.com/archives/C09LU1THDDE/p1763035653464379)

Failure examples:

-
https://github.com/hashicorp/web-unified-docs/actions/runs/19330367957/job/55291645812

	> repoDir = terraform-enterprise

-
https://github.com/hashicorp/web-unified-docs/actions/runs/19144489383/job/54718338551

	> repoDir = hcp-docs

Success examples:

-
https://github.com/hashicorp/web-unified-docs/actions/runs/19177028442/job/54824323564

	> repoDir = vault

-
https://github.com/hashicorp/web-unified-docs/actions/runs/19302738699/job/55201485701
(large, full dev portal reload)

	> repoDir = tfe and tfcommon

Author: williamdalessandro

__fixtures__/docsPathsAllVersionsMock.json

@@ -1,4 +1,13 @@
 {
+  "terraform-docs-common": {
+    "v0.0.x": [
+      {
+        "path": "terraform/plugin/debugging",
+        "itemPath": "content/terraform-docs-common/docs/plugin/debugging.mdx",
+        "created_at": "2025-06-03T18:02:21+00:00"
+      }
+    ]
+  },
   "terraform-plugin-framework": {
     "v1.14.x": [
       {

scripts/prebuild/prebuild-arm-linux-binary.gz

@@ -22,14 +22,38 @@ export function getUrlFromFilePath(
 	productConfig = PRODUCT_CONFIG,
 ) {
 	const repoDir = getProductDirectoryFromFilePath(filePath)
-	const version = getVersionFromFilePath(filePath)
 	const isValidProduct = productConfig[repoDir]
 
 	if (!isValidProduct) {
 		throw new Error(`Product not found for ${repoDir}`)
-	} else {
-		return allDocsPaths[repoDir][version].find((path) => {
-			return filePath.endsWith(path.itemPath)
-		}).path
 	}
+
+	// Check for versionless products and use v0.0.x as the version key
+	const version = productConfig[repoDir].versionedDocs
+		? getVersionFromFilePath(filePath)
+		: 'v0.0.x'
+
+	// Check if the version exists in allDocsPaths
+	if (!allDocsPaths[repoDir]) {
+		throw new Error(`No docs paths found for product: ${repoDir}`)
+	}
+
+	if (!allDocsPaths[repoDir][version]) {
+		throw new Error(
+			`Version ${version} not found for product ${repoDir}. File path: ${filePath}`,
+		)
+	}
+
+	// Find the matching path
+	const matchedPath = allDocsPaths[repoDir][version].find((path) => {
+		return filePath.endsWith(path.itemPath)
+	})
+
+	if (!matchedPath) {
+		throw new Error(
+			`No matching path found for file: ${filePath} in version ${version} of ${repoDir}`,
+		)
+	}
+
+	return matchedPath.path
 }

scripts/prebuild/prebuild-arm-mac-binary.gz

@@ -52,4 +52,105 @@ describe('getUrlFromFilePath', () => {
 			return getUrlFromFilePath(filePath, allDocsPathsJsonMock, PRODUCT_CONFIG)
 		}).toThrow(`Product not found for ${repoDir}`)
 	})
+
+	it('should use v0.0.x for versionless products (terraform-docs-common)', () => {
+		const filePath = 'content/terraform-docs-common/docs/plugin/debugging.mdx'
+		const repoDir = 'terraform-docs-common'
+		const expectedUrl = 'terraform/plugin/debugging'
+
+		getProductDirectoryFromFilePath.mockReturnValue(repoDir)
+		// versionedDocs: false, so should use v0.0.x
+
+		const result = getUrlFromFilePath(
+			filePath,
+			allDocsPathsJsonMock,
+			PRODUCT_CONFIG,
+		)
+		expect(result).toBe(expectedUrl)
+	})
+
+	it('should use v0.0.x for versionless products (hcp-docs)', () => {
+		const filePath =
+			'content/hcp-docs/content/docs/vagrant/reclaim-vagrant-cloud.mdx'
+		const repoDir = 'hcp-docs'
+		const expectedUrl = 'hcp/docs/vagrant/reclaim-vagrant-cloud'
+
+		// Add hcp-docs to product config for this test only
+		const mockProductConfig = {
+			...PRODUCT_CONFIG,
+			'hcp-docs': {
+				versionedDocs: false,
+				productSlug: 'hcp',
+			},
+		}
+
+		// Add hcp-docs to allDocsPaths for this test only
+		const mockAllDocsPaths = {
+			...allDocsPathsJsonMock,
+			'hcp-docs': {
+				'v0.0.x': [
+					{
+						path: expectedUrl,
+						itemPath: filePath,
+						created_at: '2025-06-03T18:02:21+00:00',
+					},
+				],
+			},
+		}
+
+		getProductDirectoryFromFilePath.mockReturnValue(repoDir)
+		// versionedDocs: false, so should use v0.0.x
+
+		const result = getUrlFromFilePath(
+			filePath,
+			mockAllDocsPaths,
+			mockProductConfig,
+		)
+		expect(result).toBe(expectedUrl)
+	})
+
+	it('should throw an error if no docs paths found for product', () => {
+		const filePath = 'content/terraform-plugin-framework/v1.14.x/docs/test.mdx'
+		const repoDir = 'terraform-plugin-framework'
+		const versionValue = 'v1.14.x'
+		const allDocsPathsEmpty = {}
+
+		getProductDirectoryFromFilePath.mockReturnValue(repoDir)
+		getVersionFromFilePath.mockReturnValue(versionValue)
+
+		expect(() => {
+			return getUrlFromFilePath(filePath, allDocsPathsEmpty, PRODUCT_CONFIG)
+		}).toThrow(`No docs paths found for product: ${repoDir}`)
+	})
+
+	it('should throw an error if version not found for product', () => {
+		const filePath = 'content/terraform-plugin-framework/v99.99.x/docs/test.mdx'
+		const repoDir = 'terraform-plugin-framework'
+		const versionValue = 'v99.99.x'
+
+		getProductDirectoryFromFilePath.mockReturnValue(repoDir)
+		getVersionFromFilePath.mockReturnValue(versionValue)
+
+		expect(() => {
+			return getUrlFromFilePath(filePath, allDocsPathsJsonMock, PRODUCT_CONFIG)
+		}).toThrow(
+			`Version ${versionValue} not found for product ${repoDir}. File path: ${filePath}`,
+		)
+	})
+
+	it('should throw an error if no matching path found for file', () => {
+		const filePath =
+			'content/terraform-plugin-framework/v1.14.x/docs/nonexistent-file.mdx'
+		const repoDir = 'terraform-plugin-framework'
+		const versionValue = 'v1.14.x'
+
+		getProductDirectoryFromFilePath.mockReturnValue(repoDir)
+		getVersionFromFilePath.mockReturnValue(versionValue)
+
+		expect(() => {
+			return getUrlFromFilePath(filePath, allDocsPathsJsonMock, PRODUCT_CONFIG)
+		}).toThrow(
+			`No matching path found for file: ${filePath} in version ${versionValue} of ${repoDir}`,
+		)
+	})
 })