refactor!: change Package API

This changes the following public APIs:

**(_breaking_) Events on the `Package` class**
The `uninstall:success` event on the `Package` class now receives an `InstallReceipt` as argument, instead of an
`InstallHandle`. This receipt is an in-memory representation of what was uninstalled. There's also a new
`uninstall:failed` event for situations where uninstallation for some
reason fails. Note: this also applies to the registry events (i.e.
`package:uninstall:success` and `package:uninstall:failed`).

---

**(_breaking_) `Package:uninstall()` is now asynchronous and receives two new arguments, similarly to `Package:install()`**
While package uninstallations remain synchronous under the hood, the public API has been changed from synchronous ->
asynchronous. Users of this method are recommended to provide a callback in situations where code needs to execute after
uninstallation fully completes.

---

**(_breaking_) `Package:get_install_path()` has been removed.

---

**`Package:install()` now takes an optional callback**
This callback allows consumers to be informed whether installation was successful or not without having to go through a
different, low-level, API. See below for a comparison between the old and new APIs:
```lua
-- before
local handle = pkg:install()
handle:once("closed", function ()
    -- ...
end)

-- after
pkg:install({}, function (success, result)
    -- ...
end)
```

1 files changed, 5 insertions, 5 deletions

diff --git a/tests/mason-core/installer/context_spec.lua b/tests/mason-core/installer/context_spec.lua
index 9c1805cb..d753c05f 100644
--- a/tests/mason-core/installer/context_spec.lua
+++ b/tests/mason-core/installer/context_spec.lua
@@ -104,7 +104,7 @@ cmd.exe /C echo %GREETING% %*]]
         assert.spy(ctx.write_shell_exec_wrapper).was_called_with(
             match.is_ref(ctx),
             "my-wrapper-script",
-            ("node %q"):format(path.concat { dummy:get_install_path(), js_rel_path })
+            ("node %q"):format(path.concat { ctx:get_install_path(), js_rel_path })
         )
     end)
 
@@ -122,7 +122,7 @@ cmd.exe /C echo %GREETING% %*]]
         assert.spy(ctx.write_shell_exec_wrapper).was_called_with(
             match.is_ref(ctx),
             "my-wrapper-script",
-            ("ruby %q"):format(path.concat { dummy:get_install_path(), js_rel_path })
+            ("ruby %q"):format(path.concat { ctx:get_install_path(), js_rel_path })
         )
     end)
 
@@ -157,7 +157,7 @@ cmd.exe /C echo %GREETING% %*]]
         assert.spy(ctx.write_shell_exec_wrapper).was_called_with(
             match.is_ref(ctx),
             "my-wrapper-script",
-            ("%q -m my-module"):format(path.concat { pypi.venv_path(dummy:get_install_path()), "python" })
+            ("%q -m my-module"):format(path.concat { pypi.venv_path(ctx:get_install_path()), "python" })
         )
     end)
 
@@ -196,7 +196,7 @@ cmd.exe /C echo %GREETING% %*]]
             .was_called_with(
                 match.is_ref(ctx),
                 "my-wrapper-script",
-                ("%q"):format(path.concat { dummy:get_install_path(), exec_rel_path })
+                ("%q"):format(path.concat { ctx:get_install_path(), exec_rel_path })
             )
     end)
 
@@ -229,7 +229,7 @@ cmd.exe /C echo %GREETING% %*]]
         assert.spy(ctx.write_shell_exec_wrapper).was_called_with(
             match.is_ref(ctx),
             "my-wrapper-script",
-            ("php %q"):format(path.concat { dummy:get_install_path(), php_rel_path })
+            ("php %q"):format(path.concat { ctx:get_install_path(), php_rel_path })
         )
     end)