Add AutoUpdater feature with events and facade support

[WINBIGFOX]

Introduces the AutoUpdater class to manage update processes via the client. Adds events such as UpdateAvailable, UpdateDownloaded, and others for broadcasting update states. A facade is also provided for convenient usage.

PR:
NativePHP/electron: NativePHP/electron#213

[SRWieZ]

Looks good! Did you try it on your app?

[gwleuverink]

Hey! Great addition 👍 what are your thoughts on adding a UpdateProgress event (or something like that) to a enable download progress indicator?

[WINBIGFOX]

@SRWieZ yes I have tested this in my app. Here is a log excerpt:

\Native\Laravel\Events\AutoUpdater\UpdateAvailable

\Native\Laravel\Events\AutoUpdater\DownloadProgress {"total":121891223,"delta":60969106,"transferred":60969106,"percent":50.01927497273532,"bytesPerSecond":60969106}
\Native\Laravel\Events\AutoUpdater\DownloadProgress {"total":121891223,"delta":60922117,"transferred":121891223,"percent":100,"bytesPerSecond":62316576}

\Native\Laravel\Events\AutoUpdater\UpdateDownloaded {"version":"1.0.2","downloadedFile":"/Users/WINBIGFOX/Library/Caches/timescribe-updater/pending/TimeScribe-1.0.2-arm64.zip","releaseDate":"2025-04-25T19:38:08.061Z","releaseNotes":"

<span class="issue-keyword tooltipped tooltipped-se">Fixed <a class="issue-link js-issue-link" href="https://github.com/WINBIGFOX/TimeScribe/issues/7\">#7 Add optimize command and update filesystem config

Added an `optimize` Artisan command that immediately exits. Updated the filesystem configuration to simplify the public driver and removed default storage symlink settings. These changes aim to improve maintainability and streamline application behavior.

","releaseName":"v1.0.2"}

@gwleuverink I have added the DownloadProgress event

[WINBIGFOX]

@SRWieZ Do you already know when you're planning a new release?

[SRWieZ]

I don't know unfortunately. The team is also busy releasing v1 of NativePHP for mobile this week.

[gwleuverink]

This is great! Are you up to write up something in the docs for this?

I also have some thoughts for discussion, doesn't have to block this PR.

Right now updates are downloaded automatically. Now we have a better api to handle this it might be worth adding a way to disable auto updates. I'm thinking by config and/or persisting the setting through a method on the AutoUpdater facade we can call in the service provider. Thoughts? @SRWieZ @WINBIGFOX

[gwleuverink]

Or even disable auto updates altogether and let people handle it on boot themselves

[WINBIGFOX]

@gwleuverink I can also write the documentation.

I don't think your suggestion to switch off the auto updates is a bad one. Especially if the user has deactivated the push notifications, he will not receive any information about an available update. I have also noticed in the app that users rarely restart their Mac or close the program. As a result, available updates are only rolled out very slowly.

In future, I will control the updates in my app myself so that this happens more reliably.

[SRWieZ]

Right now updates are downloaded automatically. Now we have a better api to handle this it might be worth adding a way to disable auto updates. I'm thinking by config and/or persisting the setting through a method on the AutoUpdater facade we can call in the service provider. Thoughts? @SRWieZ @WINBIGFOX

I kinda forgot about docs but @WINBIGFOX if you can write a PR for all the recent changes would be great. A single PR is fine.

@gwleuverink absolutely! As someone that disable auto update because I'm working a lot on 4G/5G network, I would absolutely love that.

[WINBIGFOX]

@gwleuverink @SRWieZ Here is the PR for the docs

NativePHP/nativephp.com#112