fix: respect executablePath in standalone mode

src/index.ts

@@ -280,8 +280,8 @@
  * Executes docker compose command with common options
  */
 export const execCompose = (
   command,
   args,
   options: IDockerComposeOptions = {}
 ): Promise<IDockerComposeResult> =>
   new Promise((resolve, reject): void => {
@@ -307,8 +307,8 @@
     let executablePath: string
     let executableArgs: string[] = []
 
-    if (executable?.standalone && !executable.executablePath) {
-      executablePath = 'docker-compose'
+    if (executable?.standalone) {
+      executablePath = executable.executablePath || 'docker-compose'
     } else {
       executablePath = executable?.executablePath || 'docker'
       const executableOptions = executable?.options || []

test/compose.test.ts

@@ -5,10 +5,12 @@
   beforeEach,
   afterEach,
   vi,
-  beforeAll
+  beforeAll,
+  MockInstance
 } from 'vitest'
 import Docker, { ContainerInfo } from 'dockerode'
 import * as compose from '../src'
+import childProcess from 'child_process'
 import * as path from 'path'
 import { readFile } from 'fs'
 import { mapPsOutput, mapImListOutput } from '../src'
@@ -165,7 +167,7 @@
       await compose.logs('non_existent_service', {
         cwd: path.join(__dirname)
       })
     } catch (error: any) {
       failedResult = error.exitCode
     }
     expect(failedResult).toBe(1)
@@ -357,7 +359,7 @@
     let errMsg
     try {
       await compose.exec('proxy', 'cat /etc/os-release', opts)
     } catch (err: any) {
       errMsg = err.err
     }
     expect(errMsg).toContain('is paused')
@@ -716,7 +718,7 @@
 
     const std = await compose.ps({ cwd: path.join(__dirname), log: logOutput })
 
     const running = await getRunningContainers()
 
     expect(std.exitCode).toBe(0)
     expect(std.data.services.length).toBe(2)
@@ -743,7 +745,7 @@
       commandOptions: [['--format', 'json']]
     })
 
     const running = await getRunningContainers()
 
     expect(std.exitCode).toBe(0)
     expect(std.data.services.length).toBe(2)
@@ -1202,3 +1204,68 @@
     })
   })
 })
+
+describe('executable path resolution', (): void => {
+  let spawnSpy: MockInstance<typeof childProcess.spawn>
+
+  beforeEach((): void => {
+    const mockProc = {
+      on: vi.fn(),
+      stdout: { on: vi.fn(), pipe: vi.fn() },
+      stderr: { on: vi.fn(), pipe: vi.fn() },
+      stdin: { write: vi.fn(), end: vi.fn() }
+    }
+
+    mockProc.on.mockImplementation((event, cb) => {
+      if (event === 'exit') {
+        setTimeout(() => cb(0), 0)
+      }
+    })
+
+    spawnSpy = vi
+      .spyOn(childProcess, 'spawn')
+      .mockReturnValue((mockProc as unknown) as childProcess.ChildProcess)
+  })
+
+  afterEach((): void => {
+    spawnSpy.mockRestore()
+  })
+
+  // spawn is always called with a third argument ({ cwd, env }) so we use
+  // expect.objectContaining({}) to match it without being brittle about its contents.
+  it('uses custom executablePath in standalone mode without appending compose', async (): Promise<void> => {
+    await compose.execCompose('up', [], {
+      executable: {
+        standalone: true,
+        executablePath: '/custom/path/docker-compose'
+      }
+    })
+    expect(spawnSpy).toHaveBeenCalledWith(
+      '/custom/path/docker-compose',
+      ['up'],
+      expect.objectContaining({})
+    )
+  })
+
+  it('defaults to docker-compose in standalone mode when no executablePath is provided', async (): Promise<void> => {
+    await compose.execCompose('up', [], {
+      executable: { standalone: true }
+    })
+    expect(spawnSpy).toHaveBeenCalledWith(
+      'docker-compose',
+      ['up'],
+      expect.objectContaining({})
+    )
+  })
+
+  it('appends compose subcommand when not in standalone mode', async (): Promise<void> => {
+    await compose.execCompose('up', [], {
+      executable: { executablePath: '/custom/docker' }
+    })
+    expect(spawnSpy).toHaveBeenCalledWith(
+      '/custom/docker',
+      ['compose', 'up'],
+      expect.objectContaining({})
+    )
+  })
+})