@noldova/desktop.electron 0.0.0-stage → 0.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +55 -2
- package/api/index.d.ts +11138 -0
- package/api/index.js +144 -0
- package/api/index.js.map +1 -0
- package/enums/file-save-outcome.js +14 -0
- package/enums/file-save-outcome.js.map +1 -0
- package/enums/main-process-failure-kind.js +13 -0
- package/enums/main-process-failure-kind.js.map +1 -0
- package/enums/menu-bar-row-type.js +14 -0
- package/enums/menu-bar-row-type.js.map +1 -0
- package/enums/menu-check.js +14 -0
- package/enums/menu-check.js.map +1 -0
- package/enums/path-command-outcome.js +16 -0
- package/enums/path-command-outcome.js.map +1 -0
- package/enums/quit-choice.js +14 -0
- package/enums/quit-choice.js.map +1 -0
- package/enums/quit-outcome.js +14 -0
- package/enums/quit-outcome.js.map +1 -0
- package/enums/startup-state-kind.js +19 -0
- package/enums/startup-state-kind.js.map +1 -0
- package/enums/tray-icon-state.js +16 -0
- package/enums/tray-icon-state.js.map +1 -0
- package/enums/update-state-kind.js +18 -0
- package/enums/update-state-kind.js.map +1 -0
- package/enums/web-address-kind.js +16 -0
- package/enums/web-address-kind.js.map +1 -0
- package/enums/window-error-admission.js +14 -0
- package/enums/window-error-admission.js.map +1 -0
- package/exceptions/app-image-folder-unwritable.exception.js +18 -0
- package/exceptions/app-image-folder-unwritable.exception.js.map +1 -0
- package/exceptions/app-image-leftover-not-removed.exception.js +17 -0
- package/exceptions/app-image-leftover-not-removed.exception.js.map +1 -0
- package/exceptions/app-image-not-replaced.exception.js +18 -0
- package/exceptions/app-image-not-replaced.exception.js.map +1 -0
- package/exceptions/app-image-unreadable.exception.js +18 -0
- package/exceptions/app-image-unreadable.exception.js.map +1 -0
- package/exceptions/databases-not-backed-up.exception.js +18 -0
- package/exceptions/databases-not-backed-up.exception.js.map +1 -0
- package/exceptions/debian-installer-missing.exception.js +15 -0
- package/exceptions/debian-installer-missing.exception.js.map +1 -0
- package/exceptions/debian-package-not-installed.exception.js +18 -0
- package/exceptions/debian-package-not-installed.exception.js.map +1 -0
- package/exceptions/device-identity.exception.js +17 -0
- package/exceptions/device-identity.exception.js.map +1 -0
- package/exceptions/electron.exception.js +14 -0
- package/exceptions/electron.exception.js.map +1 -0
- package/exceptions/installer-not-copied.exception.js +15 -0
- package/exceptions/installer-not-copied.exception.js.map +1 -0
- package/exceptions/installer-not-held.exception.js +17 -0
- package/exceptions/installer-not-held.exception.js.map +1 -0
- package/exceptions/installer-not-started.exception.js +18 -0
- package/exceptions/installer-not-started.exception.js.map +1 -0
- package/exceptions/installer-unsigned.exception.js +19 -0
- package/exceptions/installer-unsigned.exception.js.map +1 -0
- package/exceptions/not-an-app-image.exception.js +15 -0
- package/exceptions/not-an-app-image.exception.js.map +1 -0
- package/exceptions/path-command.exception.js +18 -0
- package/exceptions/path-command.exception.js.map +1 -0
- package/exceptions/processes-not-exited.exception.js +19 -0
- package/exceptions/processes-not-exited.exception.js.map +1 -0
- package/exceptions/program.exception.js +18 -0
- package/exceptions/program.exception.js.map +1 -0
- package/exceptions/restart-arguments-not-written.exception.js +15 -0
- package/exceptions/restart-arguments-not-written.exception.js.map +1 -0
- package/exceptions/runtime-starter-ended.exception.js +15 -0
- package/exceptions/runtime-starter-ended.exception.js.map +1 -0
- package/exceptions/runtime-starter-failed.exception.js +17 -0
- package/exceptions/runtime-starter-failed.exception.js.map +1 -0
- package/exceptions/ship-it-not-found.exception.js +15 -0
- package/exceptions/ship-it-not-found.exception.js.map +1 -0
- package/exceptions/ship-it-not-removed.exception.js +16 -0
- package/exceptions/ship-it-not-removed.exception.js.map +1 -0
- package/exceptions/ship-it-unreadable.exception.js +16 -0
- package/exceptions/ship-it-unreadable.exception.js.map +1 -0
- package/exceptions/stale-update.exception.js +14 -0
- package/exceptions/stale-update.exception.js.map +1 -0
- package/exceptions/unusable-folder.exception.js +18 -0
- package/exceptions/unusable-folder.exception.js.map +1 -0
- package/exceptions/update-changed-before-handoff.exception.js +15 -0
- package/exceptions/update-changed-before-handoff.exception.js.map +1 -0
- package/exceptions/update-checker-unknown.exception.js +15 -0
- package/exceptions/update-checker-unknown.exception.js.map +1 -0
- package/exceptions/update-download-interrupted.exception.js +15 -0
- package/exceptions/update-download-interrupted.exception.js.map +1 -0
- package/exceptions/update-download-mismatch.exception.js +15 -0
- package/exceptions/update-download-mismatch.exception.js.map +1 -0
- package/exceptions/update-failed-unexpectedly.exception.js +15 -0
- package/exceptions/update-failed-unexpectedly.exception.js.map +1 -0
- package/exceptions/update-feed-redirected.exception.js +15 -0
- package/exceptions/update-feed-redirected.exception.js.map +1 -0
- package/exceptions/update-feed-refused.exception.js +17 -0
- package/exceptions/update-feed-refused.exception.js.map +1 -0
- package/exceptions/update-feed-unreachable.exception.js +15 -0
- package/exceptions/update-feed-unreachable.exception.js.map +1 -0
- package/exceptions/update-handoff.exception.js +14 -0
- package/exceptions/update-handoff.exception.js.map +1 -0
- package/exceptions/update-holder-not-found.exception.js +15 -0
- package/exceptions/update-holder-not-found.exception.js.map +1 -0
- package/exceptions/update-info-invalid.exception.js +15 -0
- package/exceptions/update-info-invalid.exception.js.map +1 -0
- package/exceptions/update-no-longer-offered.exception.js +17 -0
- package/exceptions/update-no-longer-offered.exception.js.map +1 -0
- package/exceptions/update-not-signed.exception.js +15 -0
- package/exceptions/update-not-signed.exception.js.map +1 -0
- package/exceptions/update-not-staged-in-time.exception.js +15 -0
- package/exceptions/update-not-staged-in-time.exception.js.map +1 -0
- package/exceptions/update-not-staged.exception.js +15 -0
- package/exceptions/update-not-staged.exception.js.map +1 -0
- package/exceptions/update-refused.exception.js +19 -0
- package/exceptions/update-refused.exception.js.map +1 -0
- package/exceptions/update-runtime-not-found.exception.js +17 -0
- package/exceptions/update-runtime-not-found.exception.js.map +1 -0
- package/exceptions/update-runtime-not-reached.exception.js +17 -0
- package/exceptions/update-runtime-not-reached.exception.js.map +1 -0
- package/exceptions/update-runtime-still-starting.exception.js +17 -0
- package/exceptions/update-runtime-still-starting.exception.js.map +1 -0
- package/exceptions/update-stop-failed-unexpectedly.exception.js +15 -0
- package/exceptions/update-stop-failed-unexpectedly.exception.js.map +1 -0
- package/exceptions/update-stop.exception.js +14 -0
- package/exceptions/update-stop.exception.js.map +1 -0
- package/exceptions/update-under-way.exception.js +15 -0
- package/exceptions/update-under-way.exception.js.map +1 -0
- package/exceptions/update-unsaved.exception.js +19 -0
- package/exceptions/update-unsaved.exception.js.map +1 -0
- package/exceptions/update.exception.js +14 -0
- package/exceptions/update.exception.js.map +1 -0
- package/exceptions/window-state-not-connected.exception.js +15 -0
- package/exceptions/window-state-not-connected.exception.js.map +1 -0
- package/exceptions/window-state-refused.exception.js +19 -0
- package/exceptions/window-state-refused.exception.js.map +1 -0
- package/exceptions/window-state-runtime-unreachable.exception.js +15 -0
- package/exceptions/window-state-runtime-unreachable.exception.js.map +1 -0
- package/exceptions/window-state-unavailable.exception.js +14 -0
- package/exceptions/window-state-unavailable.exception.js.map +1 -0
- package/exceptions/window-state.exception.js +14 -0
- package/exceptions/window-state.exception.js.map +1 -0
- package/exceptions/work-started-meanwhile.exception.js +17 -0
- package/exceptions/work-started-meanwhile.exception.js.map +1 -0
- package/interfaces/i-app-updater.js +9 -0
- package/interfaces/i-app-updater.js.map +1 -0
- package/interfaces/i-application-host.js +9 -0
- package/interfaces/i-application-host.js.map +1 -0
- package/interfaces/i-checked-path.js +9 -0
- package/interfaces/i-checked-path.js.map +1 -0
- package/interfaces/i-clipboard-host.js +9 -0
- package/interfaces/i-clipboard-host.js.map +1 -0
- package/interfaces/i-close-guard.js +9 -0
- package/interfaces/i-close-guard.js.map +1 -0
- package/interfaces/i-command-line-host.js +9 -0
- package/interfaces/i-command-line-host.js.map +1 -0
- package/interfaces/i-context-menu-params.js +9 -0
- package/interfaces/i-context-menu-params.js.map +1 -0
- package/interfaces/i-created-updater.js +9 -0
- package/interfaces/i-created-updater.js.map +1 -0
- package/interfaces/i-device-file-store.js +9 -0
- package/interfaces/i-device-file-store.js.map +1 -0
- package/interfaces/i-dialog-host.js +9 -0
- package/interfaces/i-dialog-host.js.map +1 -0
- package/interfaces/i-display-host.js +9 -0
- package/interfaces/i-display-host.js.map +1 -0
- package/interfaces/i-dock-host.js +9 -0
- package/interfaces/i-dock-host.js.map +1 -0
- package/interfaces/i-electron.js +9 -0
- package/interfaces/i-electron.js.map +1 -0
- package/interfaces/i-feed-net-session.js +9 -0
- package/interfaces/i-feed-net-session.js.map +1 -0
- package/interfaces/i-feed-response.js +9 -0
- package/interfaces/i-feed-response.js.map +1 -0
- package/interfaces/i-feed-runtime-options.js +9 -0
- package/interfaces/i-feed-runtime-options.js.map +1 -0
- package/interfaces/i-feed-web-request.js +9 -0
- package/interfaces/i-feed-web-request.js.map +1 -0
- package/interfaces/i-ipc-event.js +9 -0
- package/interfaces/i-ipc-event.js.map +1 -0
- package/interfaces/i-ipc-host.js +9 -0
- package/interfaces/i-ipc-host.js.map +1 -0
- package/interfaces/i-ipc-owners.js +9 -0
- package/interfaces/i-ipc-owners.js.map +1 -0
- package/interfaces/i-main-process-environment.js +9 -0
- package/interfaces/i-main-process-environment.js.map +1 -0
- package/interfaces/i-main-process-log.js +9 -0
- package/interfaces/i-main-process-log.js.map +1 -0
- package/interfaces/i-main-process-options.js +9 -0
- package/interfaces/i-main-process-options.js.map +1 -0
- package/interfaces/i-main-process-tray-parts.js +9 -0
- package/interfaces/i-main-process-tray-parts.js.map +1 -0
- package/interfaces/i-main-process-update-parts.js +9 -0
- package/interfaces/i-main-process-update-parts.js.map +1 -0
- package/interfaces/i-main-process-window.js +9 -0
- package/interfaces/i-main-process-window.js.map +1 -0
- package/interfaces/i-menu-host.js +9 -0
- package/interfaces/i-menu-host.js.map +1 -0
- package/interfaces/i-native-updater.js +9 -0
- package/interfaces/i-native-updater.js.map +1 -0
- package/interfaces/i-notification-host.js +9 -0
- package/interfaces/i-notification-host.js.map +1 -0
- package/interfaces/i-parent-port.js +9 -0
- package/interfaces/i-parent-port.js.map +1 -0
- package/interfaces/i-path-command-files.js +9 -0
- package/interfaces/i-path-command-files.js.map +1 -0
- package/interfaces/i-permission-host.js +9 -0
- package/interfaces/i-permission-host.js.map +1 -0
- package/interfaces/i-preload-channels.js +9 -0
- package/interfaces/i-preload-channels.js.map +1 -0
- package/interfaces/i-preload-settings.js +9 -0
- package/interfaces/i-preload-settings.js.map +1 -0
- package/interfaces/i-preventable-event.js +9 -0
- package/interfaces/i-preventable-event.js.map +1 -0
- package/interfaces/i-program-host.js +9 -0
- package/interfaces/i-program-host.js.map +1 -0
- package/interfaces/i-protocol-host.js +9 -0
- package/interfaces/i-protocol-host.js.map +1 -0
- package/interfaces/i-quit-control-parts.js +9 -0
- package/interfaces/i-quit-control-parts.js.map +1 -0
- package/interfaces/i-quit-host.js +9 -0
- package/interfaces/i-quit-host.js.map +1 -0
- package/interfaces/i-quit-prompt.js +9 -0
- package/interfaces/i-quit-prompt.js.map +1 -0
- package/interfaces/i-runtime-connection.js +9 -0
- package/interfaces/i-runtime-connection.js.map +1 -0
- package/interfaces/i-runtime-event-owners.js +9 -0
- package/interfaces/i-runtime-event-owners.js.map +1 -0
- package/interfaces/i-runtime-launcher.js +9 -0
- package/interfaces/i-runtime-launcher.js.map +1 -0
- package/interfaces/i-scheme-registry.js +9 -0
- package/interfaces/i-scheme-registry.js.map +1 -0
- package/interfaces/i-secret-storage-host.js +9 -0
- package/interfaces/i-secret-storage-host.js.map +1 -0
- package/interfaces/i-sender-frame.js +9 -0
- package/interfaces/i-sender-frame.js.map +1 -0
- package/interfaces/i-session-host.js +9 -0
- package/interfaces/i-session-host.js.map +1 -0
- package/interfaces/i-shell-host.js +9 -0
- package/interfaces/i-shell-host.js.map +1 -0
- package/interfaces/i-ship-it-process.js +9 -0
- package/interfaces/i-ship-it-process.js.map +1 -0
- package/interfaces/i-shortcut-host.js +9 -0
- package/interfaces/i-shortcut-host.js.map +1 -0
- package/interfaces/i-shown-path-files.js +9 -0
- package/interfaces/i-shown-path-files.js.map +1 -0
- package/interfaces/i-shown-path-status.js +9 -0
- package/interfaces/i-shown-path-status.js.map +1 -0
- package/interfaces/i-spell-check-host.js +9 -0
- package/interfaces/i-spell-check-host.js.map +1 -0
- package/interfaces/i-split-path.js +9 -0
- package/interfaces/i-split-path.js.map +1 -0
- package/interfaces/i-system-notification.js +9 -0
- package/interfaces/i-system-notification.js.map +1 -0
- package/interfaces/i-theme-host.js +9 -0
- package/interfaces/i-theme-host.js.map +1 -0
- package/interfaces/i-tray-actions.js +9 -0
- package/interfaces/i-tray-actions.js.map +1 -0
- package/interfaces/i-tray-host.js +9 -0
- package/interfaces/i-tray-host.js.map +1 -0
- package/interfaces/i-tray.js +9 -0
- package/interfaces/i-tray.js.map +1 -0
- package/interfaces/i-update-check-lock.js +9 -0
- package/interfaces/i-update-check-lock.js.map +1 -0
- package/interfaces/i-update-handoff.js +9 -0
- package/interfaces/i-update-handoff.js.map +1 -0
- package/interfaces/i-update-host.js +9 -0
- package/interfaces/i-update-host.js.map +1 -0
- package/interfaces/i-update-setup.js +9 -0
- package/interfaces/i-update-setup.js.map +1 -0
- package/interfaces/i-update-target.js +9 -0
- package/interfaces/i-update-target.js.map +1 -0
- package/interfaces/i-updater.js +9 -0
- package/interfaces/i-updater.js.map +1 -0
- package/interfaces/i-utility-process-host.js +9 -0
- package/interfaces/i-utility-process-host.js.map +1 -0
- package/interfaces/i-utility-process.js +9 -0
- package/interfaces/i-utility-process.js.map +1 -0
- package/interfaces/i-web-view-attach-params.js +9 -0
- package/interfaces/i-web-view-attach-params.js.map +1 -0
- package/interfaces/i-web-view-attach-preferences.js +9 -0
- package/interfaces/i-web-view-attach-preferences.js.map +1 -0
- package/interfaces/i-web-view-contents.js +9 -0
- package/interfaces/i-web-view-contents.js.map +1 -0
- package/interfaces/i-web-view-debugger.js +9 -0
- package/interfaces/i-web-view-debugger.js.map +1 -0
- package/interfaces/i-web-view-engine.js +9 -0
- package/interfaces/i-web-view-engine.js.map +1 -0
- package/interfaces/i-web-view-guest.js +9 -0
- package/interfaces/i-web-view-guest.js.map +1 -0
- package/interfaces/i-web-view-input-event.js +9 -0
- package/interfaces/i-web-view-input-event.js.map +1 -0
- package/interfaces/i-web-view-input.js +9 -0
- package/interfaces/i-web-view-input.js.map +1 -0
- package/interfaces/i-web-view-key-event.js +9 -0
- package/interfaces/i-web-view-key-event.js.map +1 -0
- package/interfaces/i-web-view-redirect.js +9 -0
- package/interfaces/i-web-view-redirect.js.map +1 -0
- package/interfaces/i-web-view-request.js +9 -0
- package/interfaces/i-web-view-request.js.map +1 -0
- package/interfaces/i-web-view-session.js +9 -0
- package/interfaces/i-web-view-session.js.map +1 -0
- package/interfaces/i-window-contents.js +9 -0
- package/interfaces/i-window-contents.js.map +1 -0
- package/interfaces/i-window-navigation.js +9 -0
- package/interfaces/i-window-navigation.js.map +1 -0
- package/interfaces/i-window-open-details.js +9 -0
- package/interfaces/i-window-open-details.js.map +1 -0
- package/interfaces/i-window-session.js +9 -0
- package/interfaces/i-window-session.js.map +1 -0
- package/interfaces/i-window-state-store.js +9 -0
- package/interfaces/i-window-state-store.js.map +1 -0
- package/main.js +160 -0
- package/main.js.map +1 -0
- package/models/caught-failure.js +15 -0
- package/models/caught-failure.js.map +1 -0
- package/models/detached-start-reply.js +51 -0
- package/models/detached-start-reply.js.map +1 -0
- package/models/detached-start-request.js +45 -0
- package/models/detached-start-request.js.map +1 -0
- package/models/error-code.js +22 -0
- package/models/error-code.js.map +1 -0
- package/models/feed-source.js +32 -0
- package/models/feed-source.js.map +1 -0
- package/models/file-grant-request.js +35 -0
- package/models/file-grant-request.js.map +1 -0
- package/models/file-path-choice.js +38 -0
- package/models/file-path-choice.js.map +1 -0
- package/models/issued-files.js +21 -0
- package/models/issued-files.js.map +1 -0
- package/models/known-device.js +32 -0
- package/models/known-device.js.map +1 -0
- package/models/longest-text.js +35 -0
- package/models/longest-text.js.map +1 -0
- package/models/main-process-phase.js +13 -0
- package/models/main-process-phase.js.map +1 -0
- package/models/main-process-settings.js +34 -0
- package/models/main-process-settings.js.map +1 -0
- package/models/menu-bar-menu.js +25 -0
- package/models/menu-bar-menu.js.map +1 -0
- package/models/menu-bar-row.js +49 -0
- package/models/menu-bar-row.js.map +1 -0
- package/models/menu-bar.js +20 -0
- package/models/menu-bar.js.map +1 -0
- package/models/offered-file.js +50 -0
- package/models/offered-file.js.map +1 -0
- package/models/pending-quit.js +26 -0
- package/models/pending-quit.js.map +1 -0
- package/models/preload-settings.js +21 -0
- package/models/preload-settings.js.map +1 -0
- package/models/quit-question.js +22 -0
- package/models/quit-question.js.map +1 -0
- package/models/screen-area.js +31 -0
- package/models/screen-area.js.map +1 -0
- package/models/sender-info.js +18 -0
- package/models/sender-info.js.map +1 -0
- package/models/started-program.js +17 -0
- package/models/started-program.js.map +1 -0
- package/models/startup-state.js +45 -0
- package/models/startup-state.js.map +1 -0
- package/models/taskbar-identity.js +48 -0
- package/models/taskbar-identity.js.map +1 -0
- package/models/update-ready-record.js +37 -0
- package/models/update-ready-record.js.map +1 -0
- package/models/update-status.js +40 -0
- package/models/update-status.js.map +1 -0
- package/models/update-stop-result.js +22 -0
- package/models/update-stop-result.js.map +1 -0
- package/models/update-version.js +43 -0
- package/models/update-version.js.map +1 -0
- package/models/web-view-history.js +19 -0
- package/models/web-view-history.js.map +1 -0
- package/models/window-appearance.js +52 -0
- package/models/window-appearance.js.map +1 -0
- package/models/window-page.js +23 -0
- package/models/window-page.js.map +1 -0
- package/models/window-registry.js +85 -0
- package/models/window-registry.js.map +1 -0
- package/models/window-state.js +93 -0
- package/models/window-state.js.map +1 -0
- package/package.json +78 -3
- package/preload.cjs +186 -0
- package/preload.cjs.map +1 -0
- package/resources.js +1549 -0
- package/resources.js.map +1 -0
- package/services/agent-controller.js +61 -0
- package/services/agent-controller.js.map +1 -0
- package/services/app-icons.js +49 -0
- package/services/app-icons.js.map +1 -0
- package/services/app-image-environment.js +34 -0
- package/services/app-image-environment.js.map +1 -0
- package/services/app-image-handoff.js +33 -0
- package/services/app-image-handoff.js.map +1 -0
- package/services/app-image-replacement.js +82 -0
- package/services/app-image-replacement.js.map +1 -0
- package/services/app-image-restart.js +71 -0
- package/services/app-image-restart.js.map +1 -0
- package/services/app-surface-feed.js +114 -0
- package/services/app-surface-feed.js.map +1 -0
- package/services/appearance-keeper.js +67 -0
- package/services/appearance-keeper.js.map +1 -0
- package/services/application-menu.js +14 -0
- package/services/application-menu.js.map +1 -0
- package/services/child-program-host.js +59 -0
- package/services/child-program-host.js.map +1 -0
- package/services/clipboard-copier.js +82 -0
- package/services/clipboard-copier.js.map +1 -0
- package/services/close-coordinator.js +47 -0
- package/services/close-coordinator.js.map +1 -0
- package/services/command-installer.js +58 -0
- package/services/command-installer.js.map +1 -0
- package/services/daily-check-mark.js +61 -0
- package/services/daily-check-mark.js.map +1 -0
- package/services/debian-handoff.js +41 -0
- package/services/debian-handoff.js.map +1 -0
- package/services/debian-package.js +24 -0
- package/services/debian-package.js.map +1 -0
- package/services/detached-start.js +27 -0
- package/services/detached-start.js.map +1 -0
- package/services/device-file-store.js +45 -0
- package/services/device-file-store.js.map +1 -0
- package/services/device-identity.js +39 -0
- package/services/device-identity.js.map +1 -0
- package/services/device-setting-follower.js +61 -0
- package/services/device-setting-follower.js.map +1 -0
- package/services/device-state.js +51 -0
- package/services/device-state.js.map +1 -0
- package/services/electron-web-view-contents.js +96 -0
- package/services/electron-web-view-contents.js.map +1 -0
- package/services/electron-web-view-engine.js +42 -0
- package/services/electron-web-view-engine.js.map +1 -0
- package/services/electron-web-view-session.js +47 -0
- package/services/electron-web-view-session.js.map +1 -0
- package/services/feed-provider.js +84 -0
- package/services/feed-provider.js.map +1 -0
- package/services/feed-request-guard.js +63 -0
- package/services/feed-request-guard.js.map +1 -0
- package/services/feed-session.js +30 -0
- package/services/feed-session.js.map +1 -0
- package/services/feed-updater.js +119 -0
- package/services/feed-updater.js.map +1 -0
- package/services/file-dialogs.js +180 -0
- package/services/file-dialogs.js.map +1 -0
- package/services/file-grant-issuer.js +119 -0
- package/services/file-grant-issuer.js.map +1 -0
- package/services/file-presence.js +14 -0
- package/services/file-presence.js.map +1 -0
- package/services/installer-handoff.js +75 -0
- package/services/installer-handoff.js.map +1 -0
- package/services/installer-start.js +35 -0
- package/services/installer-start.js.map +1 -0
- package/services/ipc-router.js +114 -0
- package/services/ipc-router.js.map +1 -0
- package/services/layout-keeper.js +52 -0
- package/services/layout-keeper.js.map +1 -0
- package/services/local-window-state-store.js +38 -0
- package/services/local-window-state-store.js.map +1 -0
- package/services/main-process-log.js +81 -0
- package/services/main-process-log.js.map +1 -0
- package/services/main-process-record.js +19 -0
- package/services/main-process-record.js.map +1 -0
- package/services/main-process-recovery.js +98 -0
- package/services/main-process-recovery.js.map +1 -0
- package/services/main-process-services.js +34 -0
- package/services/main-process-services.js.map +1 -0
- package/services/main-process-tray.js +64 -0
- package/services/main-process-tray.js.map +1 -0
- package/services/main-process-updates.js +69 -0
- package/services/main-process-updates.js.map +1 -0
- package/services/main-process.js +530 -0
- package/services/main-process.js.map +1 -0
- package/services/menu-bar-template.js +78 -0
- package/services/menu-bar-template.js.map +1 -0
- package/services/mirrored-window-state-store.js +26 -0
- package/services/mirrored-window-state-store.js.map +1 -0
- package/services/open-web-view.js +784 -0
- package/services/open-web-view.js.map +1 -0
- package/services/open-web-view.resources.js +13 -0
- package/services/open-web-view.resources.js.map +1 -0
- package/services/open-window.js +155 -0
- package/services/open-window.js.map +1 -0
- package/services/opened-file-policy.js +46 -0
- package/services/opened-file-policy.js.map +1 -0
- package/services/path-command.js +78 -0
- package/services/path-command.js.map +1 -0
- package/services/product-app-adapter.js +30 -0
- package/services/product-app-adapter.js.map +1 -0
- package/services/publisher-check.js +78 -0
- package/services/publisher-check.js.map +1 -0
- package/services/quit-control.js +78 -0
- package/services/quit-control.js.map +1 -0
- package/services/quit-coordinator.js +98 -0
- package/services/quit-coordinator.js.map +1 -0
- package/services/quit-flow.js +59 -0
- package/services/quit-flow.js.map +1 -0
- package/services/restart-arguments.js +58 -0
- package/services/restart-arguments.js.map +1 -0
- package/services/runtime-caller.js +31 -0
- package/services/runtime-caller.js.map +1 -0
- package/services/runtime-events.js +100 -0
- package/services/runtime-events.js.map +1 -0
- package/services/runtime-requests.js +92 -0
- package/services/runtime-requests.js.map +1 -0
- package/services/runtime-startup.js +228 -0
- package/services/runtime-startup.js.map +1 -0
- package/services/runtime-window-state-store.js +50 -0
- package/services/runtime-window-state-store.js.map +1 -0
- package/services/secret-answerer.js +57 -0
- package/services/secret-answerer.js.map +1 -0
- package/services/sender-policy.js +24 -0
- package/services/sender-policy.js.map +1 -0
- package/services/shared-file-server.js +71 -0
- package/services/shared-file-server.js.map +1 -0
- package/services/shell-opener.js +88 -0
- package/services/shell-opener.js.map +1 -0
- package/services/ship-it-process.js +54 -0
- package/services/ship-it-process.js.map +1 -0
- package/services/shown-file-policy.js +95 -0
- package/services/shown-file-policy.js.map +1 -0
- package/services/spell-checker.js +62 -0
- package/services/spell-checker.js.map +1 -0
- package/services/spelling-dictionaries.js +58 -0
- package/services/spelling-dictionaries.js.map +1 -0
- package/services/squirrel-handoff.js +98 -0
- package/services/squirrel-handoff.js.map +1 -0
- package/services/stop-key-controller.js +97 -0
- package/services/stop-key-controller.js.map +1 -0
- package/services/system-notifier.js +103 -0
- package/services/system-notifier.js.map +1 -0
- package/services/terminal-relaunch.js +52 -0
- package/services/terminal-relaunch.js.map +1 -0
- package/services/tray-controller.js +164 -0
- package/services/tray-controller.js.map +1 -0
- package/services/tray-host-watcher.js +86 -0
- package/services/tray-host-watcher.js.map +1 -0
- package/services/tray-menu-template.js +42 -0
- package/services/tray-menu-template.js.map +1 -0
- package/services/tray-notices.js +76 -0
- package/services/tray-notices.js.map +1 -0
- package/services/tray-refresher.js +72 -0
- package/services/tray-refresher.js.map +1 -0
- package/services/update-barrier-gate.js +78 -0
- package/services/update-barrier-gate.js.map +1 -0
- package/services/update-barrier-watch.js +83 -0
- package/services/update-barrier-watch.js.map +1 -0
- package/services/update-bridge.js +86 -0
- package/services/update-bridge.js.map +1 -0
- package/services/update-check-lock.js +120 -0
- package/services/update-check-lock.js.map +1 -0
- package/services/update-controller.js +325 -0
- package/services/update-controller.js.map +1 -0
- package/services/update-restart.js +139 -0
- package/services/update-restart.js.map +1 -0
- package/services/update-save-coordinator.js +48 -0
- package/services/update-save-coordinator.js.map +1 -0
- package/services/update-stop.js +222 -0
- package/services/update-stop.js.map +1 -0
- package/services/update-target-connector.js +84 -0
- package/services/update-target-connector.js.map +1 -0
- package/services/update-work-question.js +84 -0
- package/services/update-work-question.js.map +1 -0
- package/services/utility-process-starter.js +47 -0
- package/services/utility-process-starter.js.map +1 -0
- package/services/web-view-attach-guard.js +41 -0
- package/services/web-view-attach-guard.js.map +1 -0
- package/services/web-view-bridge.js +55 -0
- package/services/web-view-bridge.js.map +1 -0
- package/services/web-view-event-backlog.js +38 -0
- package/services/web-view-event-backlog.js.map +1 -0
- package/services/web-view-event-cut.js +42 -0
- package/services/web-view-event-cut.js.map +1 -0
- package/services/web-view-host.js +340 -0
- package/services/web-view-host.js.map +1 -0
- package/services/web-view-key-input.js +37 -0
- package/services/web-view-key-input.js.map +1 -0
- package/services/web-view-origin-check.js +150 -0
- package/services/web-view-origin-check.js.map +1 -0
- package/services/web-view-origin-check.resources.js +46 -0
- package/services/web-view-origin-check.resources.js.map +1 -0
- package/services/window-bounds-keeper.js +145 -0
- package/services/window-bounds-keeper.js.map +1 -0
- package/services/window-controls.js +97 -0
- package/services/window-controls.js.map +1 -0
- package/services/window-error-limit.js +32 -0
- package/services/window-error-limit.js.map +1 -0
- package/services/window-factory.js +87 -0
- package/services/window-factory.js.map +1 -0
- package/services/window-placement.js +67 -0
- package/services/window-placement.js.map +1 -0
- package/services/window-recovery.js +138 -0
- package/services/window-recovery.js.map +1 -0
- package/services/window-text-log.js +37 -0
- package/services/window-text-log.js.map +1 -0
- package/utility-entry.js +11 -0
- package/utility-entry.js.map +1 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) Noldova
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,56 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Electron
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**Scope:** The `@noldova/desktop.electron` package, `src/noldova.desktop.electron`, which is Noldova Desktop's Electron main process and the window's preload, under the [window rules](../../documents/WINDOW.md#the-main-process).
|
|
4
|
+
|
|
5
|
+
## 1. Purpose
|
|
6
|
+
|
|
7
|
+
The main process starts the runtime that owns the app's data directory, or connects to the one that runs, and opens the window on the window package's build.
|
|
8
|
+
It owns what the operating system shows outside the window: the tray, notifications from the operating system, the menu bar on macOS, the taskbar's identity on Windows, the stop key, shutdown and updates, as [WINDOW.md](../../documents/WINDOW.md#the-main-process) says.
|
|
9
|
+
The window reaches it only through the preload bridge, and the main process takes each request only from the window's own page.
|
|
10
|
+
|
|
11
|
+
## 2. Use in an app
|
|
12
|
+
|
|
13
|
+
An app doesn't import the package: `@noldova/desktop.build` names its `main.js` as the app's Electron entry, in the `package.json` of the development app it starts and of every package it builds, as [BUILD.md](../../documents/BUILD.md#the-build-package) says.
|
|
14
|
+
The app installs the package at the exact version its Noldova Desktop version pins, with Electron at the version the package peers on and context's `core`, `exceptions`, `json` and `text` packages.
|
|
15
|
+
|
|
16
|
+
## 3. Entry points
|
|
17
|
+
|
|
18
|
+
| File | What it is |
|
|
19
|
+
|---|---|
|
|
20
|
+
| `main.js` | The main process: it composes `MainProcess` from Electron's own modules and starts it. |
|
|
21
|
+
| `preload.cjs` | The window's preload, which runs sandboxed and exposes the bridge the window calls. |
|
|
22
|
+
| `utility-entry.js` | The Electron utility process that starts a detached program on Windows. |
|
|
23
|
+
| `api/index.js` | The package's exports, which `api/index.d.ts` documents member by member: the main process's classes, the interfaces they take, and the exceptions the package throws, all extending `ElectronException`. |
|
|
24
|
+
|
|
25
|
+
## 4. The preload's settings
|
|
26
|
+
|
|
27
|
+
A sandboxed preload can load no file of its own beside Electron's modules, so it can't import the package's `Resources`.
|
|
28
|
+
The main process hands it everything it shares with the window instead: one `--desktop-preload=` argument of the window's renderer, the JSON of `PreloadSettings`, holds the bridge's name, the limit on pasted bytes in one call, the window's last appearance and the name of each IPC channel, all from `Resources`.
|
|
29
|
+
`Resources` owns each name once, and the preload names a channel only by its key in `IPreloadChannels`, which the compiler checks against the main process's table.
|
|
30
|
+
The preload refuses to start without valid settings, and refuses an answer other than `true` or `false` to a question the window asks as yes or no.
|
|
31
|
+
|
|
32
|
+
## 5. Failures
|
|
33
|
+
|
|
34
|
+
Every exception the package throws extends `ElectronException`, so a caller catches any of them in one place, except the two the utility-process starter throws.
|
|
35
|
+
`RuntimeStarterFailedException` and `RuntimeStarterEndedException` extend the runtime's `LaunchException` instead, so they are caught with the runtime's other start failures.
|
|
36
|
+
|
|
37
|
+
| Exception | When |
|
|
38
|
+
|---|---|
|
|
39
|
+
| `DeviceIdentityException` | This device's identity file cannot be read or holds no valid identity. |
|
|
40
|
+
| `PathCommandException` | The command cannot be linked on the macOS `PATH`. |
|
|
41
|
+
| `ProgramException` | A program cannot start, ends with an error or runs too long. |
|
|
42
|
+
| `UnusableFolderException` | The main process cannot use the data folder it was given; the message is what the start-failure box shows. |
|
|
43
|
+
| `UpdateException` | An update's check or download fails; its message is the reason the window shows. Abstract: each condition is its own subclass, such as `UpdateFeedRefusedException`. |
|
|
44
|
+
| `UpdateHandoffException`, `StaleUpdateException` | An update's handoff cannot install it, or a ready update is no longer the one to install. Abstract: each condition is its own subclass, such as `InstallerNotStartedException` or `UpdateNoLongerOfferedException`. |
|
|
45
|
+
| `UpdateStopException` | An update cannot stop the installation. Abstract: each condition is its own subclass, such as `UpdateRefusedException`. |
|
|
46
|
+
| `WindowStateException`, `WindowStateUnavailableException` | A window's state cannot be read or kept through the runtime, or the runtime cannot be reached. Abstract: `WindowStateRefusedException`, `WindowStateNotConnectedException` and `WindowStateRuntimeUnreachableException` name the conditions. |
|
|
47
|
+
|
|
48
|
+
## 6. Tests
|
|
49
|
+
|
|
50
|
+
The package's tests mirror its sources under `tests/`, and run with the repository's `npm test`, as the [repository's checks](../../README.md#checks) say.
|
|
51
|
+
Six files are left out of coverage, each with its reason in `package.json`'s `noldova.coverageExclusions`, since they load only inside Electron: `main.ts`, `services/electron-web-view-engine.ts`, `services/electron-web-view-contents.ts`, `services/electron-web-view-session.ts`, `services/product-app-adapter.ts` and `utility-entry.ts`.
|
|
52
|
+
The end-to-end workflows under `tests/e2e/` start the test build in Electron through Playwright, with `npm run test:ui`, and in CI with `npm run test:ui:ci`, which on Linux runs them under `dbus-run-session` and `xvfb-run`, so they have a session bus and a display of their own.
|
|
53
|
+
|
|
54
|
+
- **One worker:** the workflows run one at a time, since they share what a machine has one of: the system clipboard, foreground focus and the pointer, and Windows' notification history, which the tray workflow counts.
|
|
55
|
+
- **Tray host:** the two tray-quit workflows that close the last window into the tray need a tray, which a Linux session has only with a StatusNotifier host; each skips itself, with its reason, when the session bus has none, as the CI session bus on Linux has none.
|
|
56
|
+
The tray workflow that runs everywhere checks that the main process reports a tray exactly where the session bus has a host.
|