docs: refactor medusa workflows reference (#8692)

* docs: fix handling of namespaces in core flows under definitions directory

* change nested handling

* docs-util: expand workflows under definitions in workflows reference

* remove check for definitions

www/packages/build-scripts/src/generate-edited-dates.ts

@@ -39,10 +39,15 @@ const getGitEditDatesOfPaths = async (
 // date doesn't accurately represent the publish date of the file.
 const getOsLastEditDates = async (
   paths: string[]
-): Promise<Record<string, string>> => {
-  const editDates: Record<string, string> = {}
+): Promise<Record<string, string | undefined>> => {
+  const editDates: Record<string, string | undefined> = {}
   await Promise.all(
     paths.map(async (filePath) => {
+      if (!existsSync(filePath)) {
+        // indicates that file was deleted
+        editDates[filePath] = undefined
+        return
+      }
       const fileStat = await stat(filePath)
 
       editDates[filePath] = fileStat.mtime.toISOString()
@@ -117,7 +122,7 @@ export const generateEditedDates = async () => {
   const type = generatedFileExists ? "git" : "all"
 
   let files: string[] = []
-  let editDates: Record<string, string> = {}
+  let editDates: Record<string, string | undefined> = {}
 
   if (type === "all") {
     // get all files in a project
@@ -144,6 +149,11 @@ export const generateEditedDates = async () => {
     )
 
     editDates = Object.assign(existingEditDates, editDates)
+
+    // delete items that don't exist anymore (their value is undefined)
+    Object.keys(editDates)
+      .filter((key) => editDates[key] === undefined)
+      .forEach((key) => delete editDates[key])
   }
 
   await writeFile(

www/packages/build-scripts/src/utils/get-core-flows-ref-sidebar-children.ts

@@ -37,46 +37,55 @@ export default async function getCoreFlowsRefSidebarChildren(): Promise<
       continue
     }
 
-    const namespaceBasePath = path.join(basePath, directory.name, "functions")
-
-    if (!existsSync(namespaceBasePath)) {
-      continue
-    }
-
-    const childDirs = readdirSync(namespaceBasePath, {
-      withFileTypes: true,
-    })
-
     const workflowItems: ItemsToAdd[] = []
     const stepItems: ItemsToAdd[] = []
 
-    for (const childDir of childDirs) {
-      if (!childDir.isDirectory()) {
-        continue
+    const readItemsFromChildDirs = async (type: "Steps" | "Workflows") => {
+      const childNamespaceBasePath = path.join(
+        basePath,
+        directory.name,
+        `${type}_${directory.name}`,
+        "functions"
+      )
+
+      if (!existsSync(childNamespaceBasePath)) {
+        return
       }
-
-      const childDirPath = path.join(namespaceBasePath, childDir.name)
-      const childFile = readdirSync(childDirPath)
-
-      if (!childFile.length) {
-        continue
-      }
-
-      const sidebarItem = await getSidebarItemLink({
-        filePath: path.join(childDirPath, childFile[0]),
-        basePath: projPath,
-        fileBasename: childFile[0],
+      const childDirs = readdirSync(childNamespaceBasePath, {
+        withFileTypes: true,
       })
 
-      if (sidebarItem) {
-        if (childDir.name.endsWith("Workflow")) {
-          workflowItems.push(sidebarItem)
-        } else {
-          stepItems.push(sidebarItem)
+      for (const childDir of childDirs) {
+        if (!childDir.isDirectory()) {
+          continue
+        }
+
+        const childDirPath = path.join(childNamespaceBasePath, childDir.name)
+        const childFile = readdirSync(childDirPath)
+
+        if (!childFile.length) {
+          continue
+        }
+
+        const sidebarItem = await getSidebarItemLink({
+          filePath: path.join(childDirPath, childFile[0]),
+          basePath: projPath,
+          fileBasename: childFile[0],
+        })
+
+        if (sidebarItem) {
+          if (childDir.name.endsWith("Workflow")) {
+            workflowItems.push(sidebarItem)
+          } else {
+            stepItems.push(sidebarItem)
+          }
         }
       }
     }
 
+    await readItemsFromChildDirs("Steps")
+    await readItemsFromChildDirs("Workflows")
+
     if (workflowItems.length || stepItems.length) {
       const item: ItemsToAdd = {
         type: "category",