Add function to get all envrionment names

Author: graygilmore

packages/cli-kit/src/public/node/environments.test.ts

@@ -132,3 +132,47 @@ describe('loading environments', async () => {
     })
   })
 })
+
+describe('getEnvironmentNames', () => {
+  test('returns all environment names', async () => {
+    await inTemporaryDirectory(async (tmpDir) => {
+      // Given
+      const filePath = joinPath(tmpDir, fileName)
+      await writeFile(filePath, tomlEncode({environments: {environment1, environment2}}))
+
+      // When
+      const names = await environments.getEnvironmentNames(fileName, {from: tmpDir})
+
+      // Then
+      expect(names).toEqual(['environment1', 'environment2'])
+    })
+  })
+
+  describe('when no environment file exists', () => {
+    test('returns empty array', async () => {
+      await inTemporaryDirectory(async (tmpDir) => {
+        // When
+        const names = await environments.getEnvironmentNames(fileName, {from: tmpDir})
+
+        // Then
+        expect(names).toEqual([])
+      })
+    })
+  })
+
+  describe('when environment file is empty', () => {
+    test('returns empty array', async () => {
+      await inTemporaryDirectory(async (tmpDir) => {
+        // Given
+        const filePath = joinPath(tmpDir, fileName)
+        await writeFile(filePath, '# no content')
+
+        // When
+        const names = await environments.getEnvironmentNames(fileName, {from: tmpDir})
+
+        // Then
+        expect(names).toEqual([])
+      })
+    })
+  })
+})

packages/cli-kit/src/public/node/environments.ts

@@ -95,3 +95,19 @@ async function decodeEnvironments(fileName: string, options?: LoadEnvironmentOpt
 
   return environments
 }
+
+/**
+ * Gets all available environment names from a file.
+ * @param fileName - The file name to load environments from.
+ * @param options - Optional configuration for loading.
+ * @returns Array of environment names, or empty array if none found.
+ */
+export async function getEnvironmentNames(fileName: string, options?: LoadEnvironmentOptions): Promise<string[]> {
+  const environments = await decodeEnvironments(fileName, options)
+
+  if (!environments) {
+    return []
+  }
+
+  return Object.keys(environments)
+}