Project added to repo
This commit is contained in:
@@ -0,0 +1,2 @@
|
|||||||
|
# Auto detect text files and perform LF normalization
|
||||||
|
* text=auto
|
||||||
@@ -0,0 +1,21 @@
|
|||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) 2025 Andrew Zambazos
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE.
|
||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
After Width: | Height: | Size: 352 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 890 KiB |
@@ -0,0 +1,38 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<svg id="Layer_1" xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 1526 1526">
|
||||||
|
<!-- Generator: Adobe Illustrator 29.6.1, SVG Export Plug-In . SVG Version: 2.1.1 Build 9) -->
|
||||||
|
<defs>
|
||||||
|
<style>
|
||||||
|
.st0 {
|
||||||
|
fill: none;
|
||||||
|
stroke: #fff;
|
||||||
|
stroke-dasharray: 514.68 205.87;
|
||||||
|
stroke-miterlimit: 10;
|
||||||
|
stroke-width: 150px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.st1 {
|
||||||
|
fill: #1f0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.st2 {
|
||||||
|
display: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.st3 {
|
||||||
|
fill: url(#linear-gradient);
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
<linearGradient id="linear-gradient" x1="412.1" y1="-275.22" x2="1113.92" y2="426.7" gradientTransform="translate(0 687.66)" gradientUnits="userSpaceOnUse">
|
||||||
|
<stop offset="0" stop-color="#7b2eff"/>
|
||||||
|
<stop offset="1" stop-color="#0086ff"/>
|
||||||
|
</linearGradient>
|
||||||
|
</defs>
|
||||||
|
<g id="Layer_2" class="st2">
|
||||||
|
<rect class="st1" x="-1545.34" y="-222.57" width="3604.86" height="2130.85"/>
|
||||||
|
</g>
|
||||||
|
<g id="Layer_11" data-name="Layer_1">
|
||||||
|
<circle class="st0" cx="763" cy="763" r="688"/>
|
||||||
|
<circle class="st3" cx="763.01" cy="763.4" r="496.3"/>
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 1.2 KiB |
@@ -0,0 +1,49 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<svg xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 2832.51 1767.86">
|
||||||
|
<!-- Generator: Adobe Illustrator 29.6.1, SVG Export Plug-In . SVG Version: 2.1.1 Build 9) -->
|
||||||
|
<defs>
|
||||||
|
<style>
|
||||||
|
.st0 {
|
||||||
|
fill: #792fff;
|
||||||
|
}
|
||||||
|
|
||||||
|
.st1 {
|
||||||
|
fill: #1f0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.st2 {
|
||||||
|
fill: none;
|
||||||
|
stroke: #fff;
|
||||||
|
stroke-dasharray: 514.68 205.87;
|
||||||
|
stroke-miterlimit: 10;
|
||||||
|
stroke-width: 150px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.st3 {
|
||||||
|
fill: #0384ff;
|
||||||
|
}
|
||||||
|
|
||||||
|
.st4 {
|
||||||
|
display: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.st5 {
|
||||||
|
fill: url(#linear-gradient);
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
<linearGradient id="linear-gradient" x1="1599.65" y1="1234.69" x2="2301.48" y2="532.77" gradientTransform="translate(0 1767.66) scale(1 -1)" gradientUnits="userSpaceOnUse">
|
||||||
|
<stop offset="0" stop-color="#7b2eff"/>
|
||||||
|
<stop offset="1" stop-color="#0086ff"/>
|
||||||
|
</linearGradient>
|
||||||
|
</defs>
|
||||||
|
<g id="Layer_2" class="st4">
|
||||||
|
<rect class="st1" x="-357.79" y="-102.04" width="3604.86" height="2130.85"/>
|
||||||
|
</g>
|
||||||
|
<g id="Layer_1">
|
||||||
|
<circle class="st2" cx="1950.55" cy="883.53" r="688"/>
|
||||||
|
<circle class="st5" cx="1950.56" cy="883.93" r="496.3"/>
|
||||||
|
<rect class="st0" x="78.18" y="915.01" width="944.83" height="96.74" rx="48.37" ry="48.37"/>
|
||||||
|
<rect class="st3" x="328.64" y="339.26" width="689.08" height="96.74" rx="48.37" ry="48.37"/>
|
||||||
|
<rect class="st3" x="328.64" y="1466.3" width="689.08" height="96.74" rx="48.37" ry="48.37"/>
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 1.5 KiB |
@@ -0,0 +1,3 @@
|
|||||||
|
{
|
||||||
|
"bookmarks": []
|
||||||
|
}
|
||||||
@@ -0,0 +1,3 @@
|
|||||||
|
{
|
||||||
|
"home_bookmarks": []
|
||||||
|
}
|
||||||
@@ -0,0 +1,64 @@
|
|||||||
|
<!DOCTYPE html>
|
||||||
|
<html>
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
<title>SteamOS Browser</title>
|
||||||
|
<!-- Google Material Icons -->
|
||||||
|
<link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
|
||||||
|
<link rel="stylesheet" href="style.css">
|
||||||
|
<!-- This is where we will link to our SteamOS specific styles -->
|
||||||
|
<link rel="stylesheet" id="steam-os-style" href="">
|
||||||
|
</head>
|
||||||
|
<body class="bg-gray-800 text-white">
|
||||||
|
|
||||||
|
<div id="browser-bar" class="flex items-center p-2 bg-gray-900">
|
||||||
|
<div id="nav-buttons" class="flex">
|
||||||
|
<button id="back-btn" class="px-4 py-2 mr-2 bg-gray-700 rounded hover:bg-gray-600 flex items-center justify-center">
|
||||||
|
<span class="material-icons">arrow_back</span>
|
||||||
|
</button>
|
||||||
|
<button id="forward-btn" class="px-4 py-2 mr-2 bg-gray-700 rounded hover:bg-gray-600 flex items-center justify-center">
|
||||||
|
<span class="material-icons">arrow_forward</span>
|
||||||
|
</button>
|
||||||
|
<button id="reload-btn" class="px-4 py-2 mr-2 bg-gray-700 rounded hover:bg-gray-600 flex items-center justify-center">
|
||||||
|
<span class="material-icons">refresh</span>
|
||||||
|
</button>
|
||||||
|
<button id="home-btn" class="px-4 py-2 mr-2 bg-blue-600 rounded hover:bg-blue-500 flex items-center justify-center">
|
||||||
|
<span class="material-icons">home</span>
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
<input type="text" id="url-bar" class="flex-grow p-2 bg-gray-700 border border-gray-600 rounded" placeholder="https://...">
|
||||||
|
<div id="bookmark-controls" class="flex ml-2">
|
||||||
|
<button id="bookmark-btn" class="px-4 py-2 mr-2 bg-blue-600 rounded hover:bg-blue-500 flex items-center justify-center">
|
||||||
|
<span class="material-icons">star_border</span>
|
||||||
|
</button>
|
||||||
|
<button id="bookmarks-menu-btn" class="px-4 py-2 mr-2 bg-gray-700 rounded hover:bg-gray-600 flex items-center justify-center">
|
||||||
|
<span class="material-icons">bookmarks</span>
|
||||||
|
</button>
|
||||||
|
<button id="menu-btn" class="px-4 py-2 bg-gray-700 rounded hover:bg-gray-600 flex items-center justify-center">
|
||||||
|
<span class="material-icons">menu</span>
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Burger menu dropdown -->
|
||||||
|
<div id="menu-dropdown" class="hidden absolute right-2 top-16 bg-gray-800 border border-gray-600 rounded shadow-lg z-10 w-48">
|
||||||
|
<a href="#" id="settings-link" class="block px-4 py-2 text-white hover:bg-gray-700">Settings</a>
|
||||||
|
<a href="#" id="history-link" class="block px-4 py-2 text-white hover:bg-gray-700">History</a>
|
||||||
|
<a href="#" id="downloads-link" class="block px-4 py-2 text-white hover:bg-gray-700">Downloads</a>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Bookmarks dropdown menu -->
|
||||||
|
<div id="bookmarks-menu" class="hidden absolute right-2 top-16 bg-gray-800 border border-gray-600 rounded shadow-lg z-10 w-64 max-h-96 overflow-y-auto">
|
||||||
|
<div class="p-2 border-b border-gray-600">
|
||||||
|
<h3 class="text-sm font-semibold">Bookmarks</h3>
|
||||||
|
</div>
|
||||||
|
<div id="bookmarks-list" class="p-2">
|
||||||
|
<!-- Bookmarks will be populated here -->
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<webview id="webview" class="w-full h-screen" preload="pages/home-preload.js"></webview>
|
||||||
|
|
||||||
|
<script src="../renderer.js"></script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
@@ -0,0 +1,18 @@
|
|||||||
|
// home-preload.js
|
||||||
|
const { contextBridge, ipcRenderer } = require('electron');
|
||||||
|
|
||||||
|
contextBridge.exposeInMainWorld('homeAPI', {
|
||||||
|
navigateTo: (url) => ipcRenderer.sendToHost('navigate', url),
|
||||||
|
|
||||||
|
// Bookmarks
|
||||||
|
getBookmarks: () => ipcRenderer.invoke('get-home-bookmarks'),
|
||||||
|
addBookmark: (bookmark) => ipcRenderer.invoke('add-home-bookmark', bookmark),
|
||||||
|
removeBookmark: (url) => ipcRenderer.invoke('remove-home-bookmark', url),
|
||||||
|
});
|
||||||
|
// Expose settings API for settings page
|
||||||
|
contextBridge.exposeInMainWorld('settingsAPI', {
|
||||||
|
clearCookies: () => ipcRenderer.invoke('clear-cookies'),
|
||||||
|
goHome: () => ipcRenderer.invoke('go-home'),
|
||||||
|
clearBookmarks: () => ipcRenderer.invoke('clear-bookmarks'),
|
||||||
|
clearHomeBookmarks: () => ipcRenderer.invoke('clear-home-bookmarks')
|
||||||
|
});
|
||||||
@@ -0,0 +1,774 @@
|
|||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="en">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||||
|
<title>Nebula Browser - Home</title>
|
||||||
|
<!-- Google Material Icons -->
|
||||||
|
<link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
|
||||||
|
<style>
|
||||||
|
@font-face {
|
||||||
|
font-family: 'Inter';
|
||||||
|
src: url('../../assets/fonts/InterVariable.ttf') format('truetype');
|
||||||
|
}
|
||||||
|
* {
|
||||||
|
margin: 0;
|
||||||
|
padding: 0;
|
||||||
|
box-sizing: border-box;
|
||||||
|
}
|
||||||
|
|
||||||
|
body {
|
||||||
|
font-family: 'Inter', -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif;
|
||||||
|
background: #1a1724;
|
||||||
|
min-height: 100vh;
|
||||||
|
color: #333;
|
||||||
|
overflow-x: hidden;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
}
|
||||||
|
|
||||||
|
.container {
|
||||||
|
max-width: 1200px;
|
||||||
|
margin: 0 auto;
|
||||||
|
padding: 40px 20px;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
flex-grow: 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
.main-content {
|
||||||
|
flex-grow: 1;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
justify-content: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Header Section */
|
||||||
|
.header {
|
||||||
|
text-align: center;
|
||||||
|
margin-bottom: 10px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.logo {
|
||||||
|
height: 100px;
|
||||||
|
margin-bottom: 10px;
|
||||||
|
filter: drop-shadow(0 2px 10px rgba(0,0,0,0.3));
|
||||||
|
}
|
||||||
|
|
||||||
|
.title {
|
||||||
|
color: white;
|
||||||
|
font-size: 3.5rem;
|
||||||
|
font-weight: 600;
|
||||||
|
margin-top: 10px;
|
||||||
|
margin-bottom: 40px;
|
||||||
|
text-shadow: 0 2px 10px rgba(0,0,0,0.3);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Search Section */
|
||||||
|
.search-section {
|
||||||
|
text-align: center;
|
||||||
|
margin-bottom: 40px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.search-container {
|
||||||
|
position: relative;
|
||||||
|
max-width: 1000px;
|
||||||
|
margin: 0 auto;
|
||||||
|
}
|
||||||
|
|
||||||
|
.search-input {
|
||||||
|
width: 100%;
|
||||||
|
padding: 18px 60px 18px 20px;
|
||||||
|
font-size: 16px;
|
||||||
|
border: none;
|
||||||
|
border-radius: 25px;
|
||||||
|
background: rgba(255,255,255,0.95);
|
||||||
|
backdrop-filter: blur(10px);
|
||||||
|
box-shadow: 0 8px 32px rgba(0,0,0,0.1);
|
||||||
|
outline: none;
|
||||||
|
transition: all 0.3s ease;
|
||||||
|
}
|
||||||
|
|
||||||
|
.search-input:focus {
|
||||||
|
background: white;
|
||||||
|
box-shadow: 0 12px 40px rgba(0,0,0,0.15);
|
||||||
|
transform: translateY(-2px);
|
||||||
|
}
|
||||||
|
|
||||||
|
.search-button {
|
||||||
|
position: absolute;
|
||||||
|
right: 10px;
|
||||||
|
top: 50%;
|
||||||
|
transform: translateY(-50%);
|
||||||
|
background: #792fff;
|
||||||
|
border: none;
|
||||||
|
border-radius: 50%;
|
||||||
|
width: 40px;
|
||||||
|
height: 40px;
|
||||||
|
cursor: pointer;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
transition: all 0.3s ease;
|
||||||
|
}
|
||||||
|
|
||||||
|
.search-button:hover {
|
||||||
|
background: #0384ff;
|
||||||
|
transform: translateY(-50%) scale(1.1);
|
||||||
|
}
|
||||||
|
|
||||||
|
.search-button svg {
|
||||||
|
width: 18px;
|
||||||
|
height: 18px;
|
||||||
|
fill: white;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Quick Links Section */
|
||||||
|
.quick-links {
|
||||||
|
margin-bottom: 60px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.section-title {
|
||||||
|
color: white;
|
||||||
|
font-size: 1.5rem;
|
||||||
|
font-weight: 600;
|
||||||
|
margin-bottom: 30px;
|
||||||
|
text-align: center;
|
||||||
|
text-shadow: 0 2px 10px rgba(0,0,0,0.3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.links-grid {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
|
||||||
|
gap: 20px;
|
||||||
|
max-width: 1000px;
|
||||||
|
margin: 0 auto;
|
||||||
|
}
|
||||||
|
|
||||||
|
.link-item {
|
||||||
|
background: rgba(255,255,255,0.1);
|
||||||
|
backdrop-filter: blur(10px);
|
||||||
|
border-radius: 15px;
|
||||||
|
padding: 20px;
|
||||||
|
text-align: center;
|
||||||
|
text-decoration: none;
|
||||||
|
color: white;
|
||||||
|
transition: all 0.3s ease;
|
||||||
|
border: 1px solid rgba(255,255,255,0.2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.link-item:hover {
|
||||||
|
background: rgba(255,255,255,0.2);
|
||||||
|
transform: translateY(-5px);
|
||||||
|
box-shadow: 0 10px 30px rgba(0,0,0,0.2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.link-icon {
|
||||||
|
width: 48px;
|
||||||
|
height: 48px;
|
||||||
|
margin: 0 auto 12px;
|
||||||
|
background: rgba(255,255,255,0.2);
|
||||||
|
border-radius: 50%;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
font-size: 24px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.link-title {
|
||||||
|
font-weight: 500;
|
||||||
|
font-size: 14px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.link-item {
|
||||||
|
position: relative;
|
||||||
|
}
|
||||||
|
|
||||||
|
.delete-bookmark-btn {
|
||||||
|
position: absolute;
|
||||||
|
top: 5px;
|
||||||
|
right: 5px;
|
||||||
|
width: 20px;
|
||||||
|
height: 20px;
|
||||||
|
background: rgba(0,0,0,0.5);
|
||||||
|
color: white;
|
||||||
|
border: none;
|
||||||
|
border-radius: 50%;
|
||||||
|
cursor: pointer;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
font-size: 12px;
|
||||||
|
font-weight: bold;
|
||||||
|
opacity: 0;
|
||||||
|
transition: opacity 0.2s ease;
|
||||||
|
}
|
||||||
|
|
||||||
|
.link-item:hover .delete-bookmark-btn {
|
||||||
|
opacity: 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Add Link Button */
|
||||||
|
.add-link-item {
|
||||||
|
background: rgba(255,255,255,0.1);
|
||||||
|
border: 2px dashed rgba(255,255,255,0.3);
|
||||||
|
cursor: pointer;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
font-size: 48px;
|
||||||
|
color: rgba(255,255,255,0.5);
|
||||||
|
min-height: 125px; /* Ensure consistent height */
|
||||||
|
}
|
||||||
|
|
||||||
|
.add-link-item:hover {
|
||||||
|
background: rgba(255,255,255,0.2);
|
||||||
|
color: white;
|
||||||
|
border-color: white;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Modal Styles */
|
||||||
|
.modal-overlay {
|
||||||
|
position: fixed;
|
||||||
|
top: 0;
|
||||||
|
left: 0;
|
||||||
|
width: 100%;
|
||||||
|
height: 100%;
|
||||||
|
background: rgba(0, 0, 0, 0.6);
|
||||||
|
backdrop-filter: blur(5px);
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
z-index: 1000;
|
||||||
|
}
|
||||||
|
|
||||||
|
.modal-content {
|
||||||
|
background: white;
|
||||||
|
padding: 30px;
|
||||||
|
border-radius: 15px;
|
||||||
|
width: 90%;
|
||||||
|
max-width: 400px;
|
||||||
|
box-shadow: 0 10px 40px rgba(0,0,0,0.2);
|
||||||
|
animation: fadeInUp 0.3s ease forwards;
|
||||||
|
}
|
||||||
|
|
||||||
|
.modal-content h2 {
|
||||||
|
margin-top: 0;
|
||||||
|
margin-bottom: 25px;
|
||||||
|
color: #333;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
.form-group {
|
||||||
|
margin-bottom: 20px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.form-group label {
|
||||||
|
display: block;
|
||||||
|
margin-bottom: 8px;
|
||||||
|
font-weight: 500;
|
||||||
|
color: #555;
|
||||||
|
}
|
||||||
|
|
||||||
|
.form-group input {
|
||||||
|
width: 100%;
|
||||||
|
padding: 12px;
|
||||||
|
border: 1px solid #ddd;
|
||||||
|
border-radius: 8px;
|
||||||
|
font-size: 16px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.form-actions {
|
||||||
|
display: flex;
|
||||||
|
justify-content: flex-end;
|
||||||
|
gap: 10px;
|
||||||
|
margin-top: 30px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.form-actions button {
|
||||||
|
padding: 10px 20px;
|
||||||
|
border: none;
|
||||||
|
border-radius: 8px;
|
||||||
|
font-size: 16px;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: background-color 0.2s ease;
|
||||||
|
}
|
||||||
|
|
||||||
|
.form-actions button[type="submit"] {
|
||||||
|
background-color: #667eea;
|
||||||
|
color: white;
|
||||||
|
}
|
||||||
|
|
||||||
|
.form-actions button[type="submit"]:hover {
|
||||||
|
background-color: #5a67d8;
|
||||||
|
}
|
||||||
|
|
||||||
|
.form-actions button[type="button"] {
|
||||||
|
background-color: #e0e0e0;
|
||||||
|
color: #333;
|
||||||
|
}
|
||||||
|
|
||||||
|
.form-actions button[type="button"]:hover {
|
||||||
|
background-color: #ccc;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Icon Selector Styles */
|
||||||
|
.icon-selector {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: repeat(auto-fill, minmax(40px, 1fr));
|
||||||
|
gap: 8px;
|
||||||
|
max-height: 200px;
|
||||||
|
overflow-y: auto;
|
||||||
|
border: 1px solid #ddd;
|
||||||
|
border-radius: 8px;
|
||||||
|
padding: 10px;
|
||||||
|
margin-top: 8px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.icon-option {
|
||||||
|
width: 40px;
|
||||||
|
height: 40px;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
border: 2px solid transparent;
|
||||||
|
border-radius: 6px;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: all 0.2s ease;
|
||||||
|
background: #f5f5f5;
|
||||||
|
}
|
||||||
|
|
||||||
|
.icon-option:hover {
|
||||||
|
background: #e0e0e0;
|
||||||
|
border-color: #667eea;
|
||||||
|
}
|
||||||
|
|
||||||
|
.icon-option.selected {
|
||||||
|
background: #667eea;
|
||||||
|
color: white;
|
||||||
|
border-color: #5a67d8;
|
||||||
|
}
|
||||||
|
|
||||||
|
.icon-option .material-icons {
|
||||||
|
font-size: 20px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.icon-input-group {
|
||||||
|
display: flex;
|
||||||
|
gap: 10px;
|
||||||
|
margin-bottom: 10px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.icon-input-group input {
|
||||||
|
flex: 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
.icon-preview {
|
||||||
|
width: 40px;
|
||||||
|
height: 40px;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
background: #f5f5f5;
|
||||||
|
border: 1px solid #ddd;
|
||||||
|
border-radius: 6px;
|
||||||
|
font-size: 20px;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Footer */
|
||||||
|
.footer {
|
||||||
|
text-align: center;
|
||||||
|
color: rgba(255,255,255,0.7);
|
||||||
|
font-size: 14px;
|
||||||
|
margin-top: 40px;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Responsive Design */
|
||||||
|
@media (max-width: 768px) {
|
||||||
|
.container {
|
||||||
|
padding: 20px 15px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.logo {
|
||||||
|
font-size: 2.5rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.search-input {
|
||||||
|
padding: 15px 50px 15px 18px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.links-grid {
|
||||||
|
grid-template-columns: repeat(auto-fit, minmax(120px, 1fr));
|
||||||
|
gap: 15px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.recent-grid {
|
||||||
|
grid-template-columns: 1fr;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Animations */
|
||||||
|
@keyframes fadeInUp {
|
||||||
|
from {
|
||||||
|
opacity: 0;
|
||||||
|
transform: translateY(30px);
|
||||||
|
}
|
||||||
|
to {
|
||||||
|
opacity: 1;
|
||||||
|
transform: translateY(0);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.container > * {
|
||||||
|
animation: fadeInUp 0.6s ease forwards;
|
||||||
|
}
|
||||||
|
|
||||||
|
.search-section {
|
||||||
|
animation-delay: 0.1s;
|
||||||
|
}
|
||||||
|
|
||||||
|
.quick-links {
|
||||||
|
animation-delay: 0.2s;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div class="container">
|
||||||
|
<div class="main-content">
|
||||||
|
<!-- Header -->
|
||||||
|
<div class="header">
|
||||||
|
<img src="../../assets/images/Nebula-Logo.svg" alt="Nebula Browser Logo" class="logo">
|
||||||
|
<h1 class="title">Nebula Browser</h1>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Search Section -->
|
||||||
|
<div class="search-section">
|
||||||
|
<div class="search-container">
|
||||||
|
<input type="text" class="search-input" placeholder="Search" id="searchInput">
|
||||||
|
<button class="search-button" id="searchButton">
|
||||||
|
<svg viewBox="0 0 24 24">
|
||||||
|
<path d="M15.5 14h-.79l-.28-.27C15.41 12.59 16 11.11 16 9.5 16 5.91 13.09 3 9.5 3S3 5.91 3 9.5 5.91 16 9.5 16c1.61 0 3.09-.59 4.23-1.57l.27.28v.79l5 4.99L20.49 19l-4.99-5zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z"/>
|
||||||
|
</svg>
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Quick Links -->
|
||||||
|
<div class="quick-links">
|
||||||
|
<h2 class="section-title">Quick Access</h2>
|
||||||
|
<div class="links-grid" id="quickLinksGrid">
|
||||||
|
<!-- Bookmarks will be populated by JavaScript -->
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Add Bookmark Modal -->
|
||||||
|
<div id="addBookmarkModal" class="modal-overlay" style="display: none;">
|
||||||
|
<div class="modal-content">
|
||||||
|
<h2>Add New Bookmark</h2>
|
||||||
|
<form id="addBookmarkForm">
|
||||||
|
<div class="form-group">
|
||||||
|
<label for="bookmarkTitle">Title</label>
|
||||||
|
<input type="text" id="bookmarkTitle" required>
|
||||||
|
</div>
|
||||||
|
<div class="form-group">
|
||||||
|
<label for="bookmarkUrl">URL</label>
|
||||||
|
<input type="url" id="bookmarkUrl" required>
|
||||||
|
</div>
|
||||||
|
<div class="form-group">
|
||||||
|
<label for="bookmarkIcon">Icon</label>
|
||||||
|
<div class="icon-input-group">
|
||||||
|
<input type="text" id="bookmarkIcon" placeholder="Search for icon or enter emoji">
|
||||||
|
<div class="icon-preview" id="iconPreview">⭐</div>
|
||||||
|
</div>
|
||||||
|
<div class="icon-selector" id="iconSelector">
|
||||||
|
<!-- Icons will be generated dynamically -->
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="form-actions">
|
||||||
|
<button type="button" id="cancelAddBookmark">Cancel</button>
|
||||||
|
<button type="submit">Add</button>
|
||||||
|
</div>
|
||||||
|
</form>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Footer -->
|
||||||
|
<div class="footer">
|
||||||
|
<p>© 2025 Nebula Browser.</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<script type="module">
|
||||||
|
import { materialIcons } from './iconData.js';
|
||||||
|
// Search functionality
|
||||||
|
const searchInput = document.getElementById('searchInput');
|
||||||
|
const searchButton = document.getElementById('searchButton');
|
||||||
|
|
||||||
|
function performSearch() {
|
||||||
|
const query = searchInput.value.trim();
|
||||||
|
if (query) {
|
||||||
|
// Check if it's a URL
|
||||||
|
if (query.includes('.') && !query.includes(' ')) {
|
||||||
|
const url = query.startsWith('http') ? query : `https://${query}`;
|
||||||
|
navigateToUrl(url);
|
||||||
|
} else {
|
||||||
|
// Perform search
|
||||||
|
const searchUrl = `https://www.google.com/search?q=${encodeURIComponent(query)}`;
|
||||||
|
navigateToUrl(searchUrl);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function navigateToUrl(url) {
|
||||||
|
if (window.homeAPI) {
|
||||||
|
window.homeAPI.navigateTo(url);
|
||||||
|
} else {
|
||||||
|
console.error('Home API not available');
|
||||||
|
// Fallback for when preload script fails
|
||||||
|
window.parent.postMessage({ type: 'navigate', url: url }, '*');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
searchButton.addEventListener('click', performSearch);
|
||||||
|
searchInput.addEventListener('keypress', (e) => {
|
||||||
|
if (e.key === 'Enter') {
|
||||||
|
performSearch();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// Quick links and recent items navigation
|
||||||
|
document.addEventListener('click', (e) => {
|
||||||
|
// Handle delete button click
|
||||||
|
if (e.target.classList.contains('delete-bookmark-btn')) {
|
||||||
|
e.preventDefault();
|
||||||
|
e.stopPropagation();
|
||||||
|
const urlToDelete = e.target.dataset.url;
|
||||||
|
deleteBookmark(urlToDelete);
|
||||||
|
return; // Stop further processing
|
||||||
|
}
|
||||||
|
|
||||||
|
// Handle add bookmark button click
|
||||||
|
if (e.target.id === 'addBookmarkBtn' || e.target.closest('#addBookmarkBtn')) {
|
||||||
|
modal.style.display = 'flex';
|
||||||
|
resetModal();
|
||||||
|
return; // Stop further processing
|
||||||
|
}
|
||||||
|
|
||||||
|
// Handle navigation for links
|
||||||
|
const linkItem = e.target.closest('.link-item');
|
||||||
|
if (linkItem) {
|
||||||
|
e.preventDefault();
|
||||||
|
const url = linkItem.dataset.url;
|
||||||
|
if (url) {
|
||||||
|
navigateToUrl(url);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// Focus search input on load
|
||||||
|
window.addEventListener('load', () => {
|
||||||
|
searchInput.focus();
|
||||||
|
loadQuickLinks();
|
||||||
|
});
|
||||||
|
|
||||||
|
// Handle keyboard shortcuts
|
||||||
|
document.addEventListener('keydown', (e) => {
|
||||||
|
// Ctrl+L or F6 to focus address bar (search input)
|
||||||
|
if ((e.ctrlKey && e.key === 'l') || e.key === 'F6') {
|
||||||
|
e.preventDefault();
|
||||||
|
searchInput.focus();
|
||||||
|
searchInput.select();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// Load quick links from bookmarks
|
||||||
|
async function loadQuickLinks() {
|
||||||
|
const quickLinksGrid = document.getElementById('quickLinksGrid');
|
||||||
|
if (!quickLinksGrid) return;
|
||||||
|
|
||||||
|
if (window.homeAPI && window.homeAPI.getBookmarks) {
|
||||||
|
try {
|
||||||
|
const { home_bookmarks } = await window.homeAPI.getBookmarks();
|
||||||
|
quickLinksGrid.innerHTML = ''; // Clear existing links
|
||||||
|
|
||||||
|
if (home_bookmarks && home_bookmarks.length > 0) {
|
||||||
|
home_bookmarks.forEach(bookmark => {
|
||||||
|
const linkItem = document.createElement('a');
|
||||||
|
linkItem.href = '#';
|
||||||
|
linkItem.className = 'link-item';
|
||||||
|
linkItem.dataset.url = bookmark.url;
|
||||||
|
|
||||||
|
const linkIcon = document.createElement('div');
|
||||||
|
linkIcon.className = 'link-icon';
|
||||||
|
|
||||||
|
// Check if it's a Material Icon or emoji
|
||||||
|
if (bookmark.icon && bookmark.icon.startsWith('material:')) {
|
||||||
|
const materialIcon = document.createElement('span');
|
||||||
|
materialIcon.className = 'material-icons';
|
||||||
|
materialIcon.textContent = bookmark.icon.replace('material:', '');
|
||||||
|
linkIcon.appendChild(materialIcon);
|
||||||
|
} else {
|
||||||
|
linkIcon.textContent = bookmark.icon || '⭐';
|
||||||
|
}
|
||||||
|
|
||||||
|
const linkTitle = document.createElement('div');
|
||||||
|
linkTitle.className = 'link-title';
|
||||||
|
linkTitle.textContent = bookmark.title;
|
||||||
|
|
||||||
|
const deleteBtn = document.createElement('button');
|
||||||
|
deleteBtn.className = 'delete-bookmark-btn';
|
||||||
|
deleteBtn.textContent = 'x';
|
||||||
|
deleteBtn.dataset.url = bookmark.url;
|
||||||
|
|
||||||
|
linkItem.appendChild(linkIcon);
|
||||||
|
linkItem.appendChild(linkTitle);
|
||||||
|
linkItem.appendChild(deleteBtn);
|
||||||
|
quickLinksGrid.appendChild(linkItem);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
// Add the "Add" button
|
||||||
|
const addButton = document.createElement('div');
|
||||||
|
addButton.className = 'link-item add-link-item';
|
||||||
|
addButton.id = 'addBookmarkBtn';
|
||||||
|
addButton.textContent = '+';
|
||||||
|
quickLinksGrid.appendChild(addButton);
|
||||||
|
|
||||||
|
} catch (error) {
|
||||||
|
console.error('Error loading home bookmarks:', error);
|
||||||
|
quickLinksGrid.innerHTML = '<p style="color: white; text-align: center; grid-column: 1 / -1;">Could not load bookmarks.</p>';
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
console.error('Home API for bookmarks not available');
|
||||||
|
quickLinksGrid.innerHTML = '<p style="color: white; text-align: center; grid-column: 1 / -1;">Could not load bookmarks.</p>';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Modal handling
|
||||||
|
const modal = document.getElementById('addBookmarkModal');
|
||||||
|
const cancelBtn = document.getElementById('cancelAddBookmark');
|
||||||
|
const form = document.getElementById('addBookmarkForm');
|
||||||
|
|
||||||
|
// Icon selector functionality
|
||||||
|
const iconInput = document.getElementById('bookmarkIcon');
|
||||||
|
const iconPreview = document.getElementById('iconPreview');
|
||||||
|
const iconSelector = document.getElementById('iconSelector');
|
||||||
|
// Dynamically generate icon options
|
||||||
|
materialIcons.forEach(name => {
|
||||||
|
const option = document.createElement('div');
|
||||||
|
option.className = 'icon-option';
|
||||||
|
option.dataset.icon = name;
|
||||||
|
const span = document.createElement('span');
|
||||||
|
span.className = 'material-icons';
|
||||||
|
span.textContent = name;
|
||||||
|
option.appendChild(span);
|
||||||
|
iconSelector.appendChild(option);
|
||||||
|
});
|
||||||
|
let selectedIconType = 'emoji'; // 'emoji' or 'material'
|
||||||
|
let selectedIcon = '⭐';
|
||||||
|
|
||||||
|
// Handle icon input changes
|
||||||
|
iconInput.addEventListener('input', (e) => {
|
||||||
|
const value = e.target.value.trim();
|
||||||
|
if (value) {
|
||||||
|
selectedIconType = 'emoji';
|
||||||
|
selectedIcon = value;
|
||||||
|
updateIconPreview(value);
|
||||||
|
clearIconSelection();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// Handle icon selector clicks
|
||||||
|
iconSelector.addEventListener('click', (e) => {
|
||||||
|
const iconOption = e.target.closest('.icon-option');
|
||||||
|
if (iconOption) {
|
||||||
|
const iconName = iconOption.dataset.icon;
|
||||||
|
selectedIconType = 'material';
|
||||||
|
selectedIcon = iconName;
|
||||||
|
|
||||||
|
// Update input and preview
|
||||||
|
iconInput.value = iconName;
|
||||||
|
updateIconPreview(`material:${iconName}`);
|
||||||
|
|
||||||
|
// Update selection visual
|
||||||
|
clearIconSelection();
|
||||||
|
iconOption.classList.add('selected');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
function updateIconPreview(icon) {
|
||||||
|
iconPreview.innerHTML = '';
|
||||||
|
if (icon.startsWith('material:')) {
|
||||||
|
const materialIcon = document.createElement('span');
|
||||||
|
materialIcon.className = 'material-icons';
|
||||||
|
materialIcon.textContent = icon.replace('material:', '');
|
||||||
|
iconPreview.appendChild(materialIcon);
|
||||||
|
} else {
|
||||||
|
iconPreview.textContent = icon || '⭐';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function clearIconSelection() {
|
||||||
|
iconSelector.querySelectorAll('.icon-option').forEach(option => {
|
||||||
|
option.classList.remove('selected');
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
// Reset modal when opened
|
||||||
|
function resetModal() {
|
||||||
|
form.reset();
|
||||||
|
selectedIconType = 'emoji';
|
||||||
|
selectedIcon = '⭐';
|
||||||
|
updateIconPreview('⭐');
|
||||||
|
clearIconSelection();
|
||||||
|
}
|
||||||
|
|
||||||
|
cancelBtn.addEventListener('click', () => {
|
||||||
|
modal.style.display = 'none';
|
||||||
|
});
|
||||||
|
|
||||||
|
modal.addEventListener('click', (e) => {
|
||||||
|
if (e.target === modal) {
|
||||||
|
modal.style.display = 'none';
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
form.addEventListener('submit', async (e) => {
|
||||||
|
e.preventDefault();
|
||||||
|
const title = document.getElementById('bookmarkTitle').value;
|
||||||
|
const url = document.getElementById('bookmarkUrl').value;
|
||||||
|
|
||||||
|
// Determine the final icon format
|
||||||
|
let icon;
|
||||||
|
if (selectedIconType === 'material') {
|
||||||
|
icon = `material:${selectedIcon}`;
|
||||||
|
} else {
|
||||||
|
icon = selectedIcon || iconInput.value || '⭐';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (window.homeAPI && window.homeAPI.addBookmark) {
|
||||||
|
const result = await window.homeAPI.addBookmark({ title, url, icon });
|
||||||
|
if (result.success) {
|
||||||
|
loadQuickLinks();
|
||||||
|
modal.style.display = 'none';
|
||||||
|
resetModal();
|
||||||
|
} else {
|
||||||
|
alert(result.message);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
async function deleteBookmark(url) {
|
||||||
|
if (window.homeAPI && window.homeAPI.removeBookmark) {
|
||||||
|
const result = await window.homeAPI.removeBookmark(url);
|
||||||
|
if (result.success) {
|
||||||
|
loadQuickLinks();
|
||||||
|
} else {
|
||||||
|
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
</script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
@@ -0,0 +1,377 @@
|
|||||||
|
// List of popular Material Icons
|
||||||
|
export const materialIcons = [
|
||||||
|
'home',
|
||||||
|
'favorite',
|
||||||
|
'star',
|
||||||
|
'work',
|
||||||
|
'school',
|
||||||
|
'shopping_cart',
|
||||||
|
'music_note',
|
||||||
|
'movie',
|
||||||
|
'games',
|
||||||
|
'sports_esports',
|
||||||
|
'library_books',
|
||||||
|
'camera_alt',
|
||||||
|
'flight',
|
||||||
|
'restaurant',
|
||||||
|
'sports_soccer',
|
||||||
|
'code',
|
||||||
|
'build',
|
||||||
|
'palette',
|
||||||
|
'analytics',
|
||||||
|
'security',
|
||||||
|
'account_circle',
|
||||||
|
'alarm',
|
||||||
|
'alarm_on',
|
||||||
|
'android',
|
||||||
|
'apartment',
|
||||||
|
'arrow_back',
|
||||||
|
'arrow_forward',
|
||||||
|
'attach_file',
|
||||||
|
'autorenew',
|
||||||
|
'book',
|
||||||
|
'bookmark',
|
||||||
|
'build_circle',
|
||||||
|
'calendar_today',
|
||||||
|
'chevron_left',
|
||||||
|
'chevron_right',
|
||||||
|
'cloud',
|
||||||
|
'delete',
|
||||||
|
'directions',
|
||||||
|
'edit',
|
||||||
|
'email',
|
||||||
|
'add',
|
||||||
|
'add_alert',
|
||||||
|
'add_box',
|
||||||
|
'add_circle',
|
||||||
|
'add_circle_outline',
|
||||||
|
'adjust',
|
||||||
|
'airline_seat_flat',
|
||||||
|
'airline_seat_individual_suite',
|
||||||
|
'airplanemode_active',
|
||||||
|
'announcement',
|
||||||
|
'aspect_ratio',
|
||||||
|
'assessment',
|
||||||
|
'assignment',
|
||||||
|
'assistant',
|
||||||
|
'attach_money',
|
||||||
|
'attachment',
|
||||||
|
'backspace',
|
||||||
|
'backup',
|
||||||
|
'battery_alert',
|
||||||
|
'beenhere',
|
||||||
|
'block',
|
||||||
|
'bluetooth',
|
||||||
|
'bluetooth_audio',
|
||||||
|
'book_online',
|
||||||
|
'bookmark_border',
|
||||||
|
'border_all',
|
||||||
|
'brightness_1',
|
||||||
|
'brightness_2',
|
||||||
|
'brightness_7',
|
||||||
|
'bug_report',
|
||||||
|
'cached',
|
||||||
|
'cake',
|
||||||
|
'call',
|
||||||
|
'camera',
|
||||||
|
'cancel_presentation',
|
||||||
|
'card_giftcard',
|
||||||
|
'casino',
|
||||||
|
'cast',
|
||||||
|
'change_history',
|
||||||
|
'check',
|
||||||
|
'check_box',
|
||||||
|
'check_circle',
|
||||||
|
'child_care',
|
||||||
|
'chrome_reader_mode',
|
||||||
|
'class',
|
||||||
|
'clean_hands',
|
||||||
|
'clear',
|
||||||
|
'close',
|
||||||
|
'cloud_download',
|
||||||
|
'cloud_upload',
|
||||||
|
'code_off',
|
||||||
|
'collections',
|
||||||
|
'color_lens',
|
||||||
|
'comment',
|
||||||
|
'compare_arrows',
|
||||||
|
'computer',
|
||||||
|
'confirmation_number',
|
||||||
|
'contact_mail',
|
||||||
|
'content_copy',
|
||||||
|
'content_paste',
|
||||||
|
'control_point',
|
||||||
|
'copyright',
|
||||||
|
'create',
|
||||||
|
'credit_card',
|
||||||
|
'crop',
|
||||||
|
'dashboard',
|
||||||
|
'date_range',
|
||||||
|
'delete_forever',
|
||||||
|
'description',
|
||||||
|
'desktop_mac',
|
||||||
|
'desktop_windows',
|
||||||
|
'directions_bike',
|
||||||
|
'directions_boat',
|
||||||
|
'directions_bus',
|
||||||
|
'directions_car',
|
||||||
|
'directions_run',
|
||||||
|
'directions_transit',
|
||||||
|
'dns',
|
||||||
|
'done',
|
||||||
|
'done_all',
|
||||||
|
'donut_large',
|
||||||
|
'double_arrow',
|
||||||
|
'drafts',
|
||||||
|
'drag_handle',
|
||||||
|
'drive_eta',
|
||||||
|
'dvr',
|
||||||
|
'edit_attributes',
|
||||||
|
'eject',
|
||||||
|
'emoji_emotions',
|
||||||
|
'event',
|
||||||
|
'exit_to_app',
|
||||||
|
'expand_less',
|
||||||
|
'expand_more',
|
||||||
|
'explore',
|
||||||
|
'extension',
|
||||||
|
'face',
|
||||||
|
'favorite_border',
|
||||||
|
'file_copy',
|
||||||
|
'filter_list',
|
||||||
|
'flag',
|
||||||
|
'flaky',
|
||||||
|
'flight_takeoff',
|
||||||
|
'folder',
|
||||||
|
'format_bold',
|
||||||
|
'format_clear',
|
||||||
|
'format_color_fill',
|
||||||
|
'format_indent_decrease',
|
||||||
|
'format_indent_increase',
|
||||||
|
'format_italic',
|
||||||
|
'format_list_bulleted',
|
||||||
|
'format_list_numbered',
|
||||||
|
'format_quote',
|
||||||
|
'format_underlined',
|
||||||
|
'forum',
|
||||||
|
'forward',
|
||||||
|
'fullscreen',
|
||||||
|
'functions',
|
||||||
|
'g_translate',
|
||||||
|
'gesture',
|
||||||
|
'get_app',
|
||||||
|
'gif',
|
||||||
|
'grade',
|
||||||
|
'group',
|
||||||
|
'help',
|
||||||
|
'history',
|
||||||
|
'home_filled',
|
||||||
|
'hourglass_empty',
|
||||||
|
'http',
|
||||||
|
'image',
|
||||||
|
'input',
|
||||||
|
'insert_chart',
|
||||||
|
'invert_colors',
|
||||||
|
'iso',
|
||||||
|
'keyboard',
|
||||||
|
'label',
|
||||||
|
'language',
|
||||||
|
'laptop_mac',
|
||||||
|
'launch',
|
||||||
|
'lightbulb',
|
||||||
|
'line_style',
|
||||||
|
'link',
|
||||||
|
'list',
|
||||||
|
'list_alt',
|
||||||
|
'lock',
|
||||||
|
'lock_open',
|
||||||
|
'loop',
|
||||||
|
'loupe',
|
||||||
|
'mail_outline',
|
||||||
|
'map',
|
||||||
|
'markunread_mailbox',
|
||||||
|
'memory',
|
||||||
|
'menu',
|
||||||
|
'merge_type',
|
||||||
|
'mic',
|
||||||
|
'mic_off',
|
||||||
|
'mood',
|
||||||
|
'more_horiz',
|
||||||
|
'more_vert',
|
||||||
|
'mouse',
|
||||||
|
'movie_creation',
|
||||||
|
'multiline_chart',
|
||||||
|
'music_video',
|
||||||
|
'nature',
|
||||||
|
'navigate_before',
|
||||||
|
'navigate_next',
|
||||||
|
'network_cell',
|
||||||
|
'new_releases',
|
||||||
|
'nfc',
|
||||||
|
'no_encryption',
|
||||||
|
'not_interested',
|
||||||
|
'open_in_browser',
|
||||||
|
'open_with',
|
||||||
|
'pageview',
|
||||||
|
'pan_tool',
|
||||||
|
'pause',
|
||||||
|
'payment',
|
||||||
|
'people',
|
||||||
|
'perm_camera_mic',
|
||||||
|
'perm_contact_calendar',
|
||||||
|
'perm_identity',
|
||||||
|
'perm_media',
|
||||||
|
'perm_phone_msg',
|
||||||
|
'perm_scan_wifi',
|
||||||
|
'person',
|
||||||
|
'person_add',
|
||||||
|
'photo',
|
||||||
|
'pie_chart',
|
||||||
|
'pin_drop',
|
||||||
|
'place',
|
||||||
|
'play_arrow',
|
||||||
|
'play_circle_filled',
|
||||||
|
'playlist_add',
|
||||||
|
'poll',
|
||||||
|
'polymer',
|
||||||
|
'power_settings_new',
|
||||||
|
'print',
|
||||||
|
'priority_high',
|
||||||
|
'public',
|
||||||
|
'publish',
|
||||||
|
'query_builder',
|
||||||
|
'question_answer',
|
||||||
|
'radio',
|
||||||
|
'receipt',
|
||||||
|
'redo',
|
||||||
|
'refresh',
|
||||||
|
'remove',
|
||||||
|
'remove_circle',
|
||||||
|
'reorder',
|
||||||
|
'report',
|
||||||
|
'report_problem',
|
||||||
|
'restaurant_menu',
|
||||||
|
'restore',
|
||||||
|
'ring_volume',
|
||||||
|
'room',
|
||||||
|
'rotate_left',
|
||||||
|
'rotate_right',
|
||||||
|
'rounded_corner',
|
||||||
|
'rowing',
|
||||||
|
'rss_feed',
|
||||||
|
'rv_hookup',
|
||||||
|
'satellite',
|
||||||
|
'save',
|
||||||
|
'scanner',
|
||||||
|
'schedule',
|
||||||
|
'screen_lock_landscape',
|
||||||
|
'screen_lock_portrait',
|
||||||
|
'screen_rotation',
|
||||||
|
'sd_storage',
|
||||||
|
'search',
|
||||||
|
'send',
|
||||||
|
'settings',
|
||||||
|
'settings_cell',
|
||||||
|
'settings_backup_restore',
|
||||||
|
'settings_input_component',
|
||||||
|
'share',
|
||||||
|
'shield',
|
||||||
|
'shop',
|
||||||
|
'shopping_bag',
|
||||||
|
'shuffle',
|
||||||
|
'signal_cellular_4_bar',
|
||||||
|
'sim_card',
|
||||||
|
'skip_next',
|
||||||
|
'skip_previous',
|
||||||
|
'slideshow',
|
||||||
|
'smartphone',
|
||||||
|
'smoke_free',
|
||||||
|
'sms',
|
||||||
|
'snooze',
|
||||||
|
'sort',
|
||||||
|
'spa',
|
||||||
|
'spellcheck',
|
||||||
|
'star_border',
|
||||||
|
'star_half',
|
||||||
|
'stars',
|
||||||
|
'stay_primary_landscape',
|
||||||
|
'stay_current_portrait',
|
||||||
|
'stop',
|
||||||
|
'storage',
|
||||||
|
'store',
|
||||||
|
'straighten',
|
||||||
|
'streetview',
|
||||||
|
'style',
|
||||||
|
'swap_calls',
|
||||||
|
'sync',
|
||||||
|
'system_update_alt',
|
||||||
|
'tab',
|
||||||
|
'table_chart',
|
||||||
|
'tag',
|
||||||
|
'text_fields',
|
||||||
|
'text_format',
|
||||||
|
'thumb_down',
|
||||||
|
'thumb_up',
|
||||||
|
'thumbs_up_down',
|
||||||
|
'time_to_leave',
|
||||||
|
'timer',
|
||||||
|
'timer_off',
|
||||||
|
'toc',
|
||||||
|
'today',
|
||||||
|
'toll',
|
||||||
|
'tonality',
|
||||||
|
'touch_app',
|
||||||
|
'traffic',
|
||||||
|
'train',
|
||||||
|
'tram',
|
||||||
|
'transfer_within_a_station',
|
||||||
|
'translate',
|
||||||
|
'trending_down',
|
||||||
|
'trending_flat',
|
||||||
|
'trending_up',
|
||||||
|
'tune',
|
||||||
|
'turned_in',
|
||||||
|
'turned_in_not',
|
||||||
|
'unarchive',
|
||||||
|
'undo',
|
||||||
|
'unfold_less',
|
||||||
|
'unfold_more',
|
||||||
|
'update',
|
||||||
|
'usb',
|
||||||
|
'verified_user',
|
||||||
|
'vertical_align_bottom',
|
||||||
|
'vertical_align_center',
|
||||||
|
'vertical_align_top',
|
||||||
|
'vibration',
|
||||||
|
'video_call',
|
||||||
|
'video_label',
|
||||||
|
'video_library',
|
||||||
|
'visibility',
|
||||||
|
'visibility_off',
|
||||||
|
'voice_chat',
|
||||||
|
'voicemail',
|
||||||
|
'volume_down',
|
||||||
|
'volume_mute',
|
||||||
|
'volume_off',
|
||||||
|
'volume_up',
|
||||||
|
'vpn_key',
|
||||||
|
'wallpaper',
|
||||||
|
'warning',
|
||||||
|
'watch',
|
||||||
|
'wb_auto',
|
||||||
|
'wb_cloudy',
|
||||||
|
'wb_incandescent',
|
||||||
|
'wb_iridescent',
|
||||||
|
'wb_sunny',
|
||||||
|
'web',
|
||||||
|
'whatshot',
|
||||||
|
'widgets',
|
||||||
|
'wifi',
|
||||||
|
'wifi_off',
|
||||||
|
'work_outline',
|
||||||
|
'youtube_searched_for',
|
||||||
|
'zoom_in',
|
||||||
|
'alternate_email',
|
||||||
|
'fax',
|
||||||
|
'zoom_out'
|
||||||
|
];
|
||||||
@@ -0,0 +1,93 @@
|
|||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="en">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||||
|
<title>Nebula Browser - Settings</title>
|
||||||
|
<link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
|
||||||
|
<link rel="stylesheet" href="../style.css">
|
||||||
|
<style>
|
||||||
|
body {
|
||||||
|
background: #1a1724;
|
||||||
|
color: white;
|
||||||
|
}
|
||||||
|
.container {
|
||||||
|
padding: 20px;
|
||||||
|
}
|
||||||
|
.settings-section {
|
||||||
|
background: rgba(255, 255, 255, 0.1);
|
||||||
|
border-radius: 8px;
|
||||||
|
padding: 20px;
|
||||||
|
margin-bottom: 20px;
|
||||||
|
}
|
||||||
|
.settings-section h2 {
|
||||||
|
margin-top: 0;
|
||||||
|
border-bottom: 1px solid rgba(255, 255, 255, 0.2);
|
||||||
|
padding-bottom: 10px;
|
||||||
|
margin-bottom: 20px;
|
||||||
|
}
|
||||||
|
.setting-item {
|
||||||
|
display: flex;
|
||||||
|
justify-content: space-between;
|
||||||
|
align-items: center;
|
||||||
|
padding: 15px 0;
|
||||||
|
}
|
||||||
|
.setting-item p {
|
||||||
|
margin: 0;
|
||||||
|
}
|
||||||
|
.setting-item .description {
|
||||||
|
font-size: 0.9em;
|
||||||
|
color: rgba(255, 255, 255, 0.7);
|
||||||
|
}
|
||||||
|
button {
|
||||||
|
background-color: #792fff;
|
||||||
|
color: white;
|
||||||
|
border: none;
|
||||||
|
padding: 10px 15px;
|
||||||
|
border-radius: 5px;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: background-color 0.3s ease;
|
||||||
|
}
|
||||||
|
button:hover {
|
||||||
|
background-color: #0384ff;
|
||||||
|
}
|
||||||
|
#backToHome {
|
||||||
|
margin-top: 20px;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div class="container">
|
||||||
|
<h1>Settings</h1>
|
||||||
|
|
||||||
|
<div class="settings-section">
|
||||||
|
<h2>Privacy and Security</h2>
|
||||||
|
<div class="setting-item">
|
||||||
|
<div>
|
||||||
|
<p>Clear browsing data</p>
|
||||||
|
<span class="description">Clear cookies, and other site data.</span>
|
||||||
|
</div>
|
||||||
|
<button id="clearCookiesBtn">Clear data</button>
|
||||||
|
</div>
|
||||||
|
<div class="setting-item">
|
||||||
|
<div>
|
||||||
|
<p>Clear bookmarks</p>
|
||||||
|
<span class="description">Remove all bookmarks from bookmarks.json.</span>
|
||||||
|
</div>
|
||||||
|
<button id="clearBookmarksBtn">Clear bookmarks</button>
|
||||||
|
</div>
|
||||||
|
<div class="setting-item">
|
||||||
|
<div>
|
||||||
|
<p>Clear home bookmarks</p>
|
||||||
|
<span class="description">Remove all bookmarks from home-bookmarks.json.</span>
|
||||||
|
</div>
|
||||||
|
<button id="clearHomeBookmarksBtn">Clear home bookmarks</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<button id="backToHome">Back to Home</button>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<script src="./settings.js"></script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
@@ -0,0 +1,65 @@
|
|||||||
|
document.addEventListener('DOMContentLoaded', () => {
|
||||||
|
const clearCookiesBtn = document.getElementById('clearCookiesBtn');
|
||||||
|
const backToHomeBtn = document.getElementById('backToHome');
|
||||||
|
|
||||||
|
if (clearCookiesBtn) {
|
||||||
|
clearCookiesBtn.addEventListener('click', () => {
|
||||||
|
if (window.settingsAPI && window.settingsAPI.clearCookies) {
|
||||||
|
window.settingsAPI.clearCookies();
|
||||||
|
alert('Cookies have been cleared.');
|
||||||
|
} else {
|
||||||
|
console.error('Settings API not available.');
|
||||||
|
alert('Could not clear cookies. API not found.');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
if (backToHomeBtn) {
|
||||||
|
backToHomeBtn.addEventListener('click', () => {
|
||||||
|
if (window.settingsAPI && window.settingsAPI.goHome) {
|
||||||
|
window.settingsAPI.goHome();
|
||||||
|
} else {
|
||||||
|
// Fallback if the API isn't available
|
||||||
|
window.history.back();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
// Clear bookmarks button
|
||||||
|
const clearBookmarksBtn = document.getElementById('clearBookmarksBtn');
|
||||||
|
if (clearBookmarksBtn) {
|
||||||
|
clearBookmarksBtn.addEventListener('click', () => {
|
||||||
|
if (window.settingsAPI && window.settingsAPI.clearBookmarks) {
|
||||||
|
window.settingsAPI.clearBookmarks().then(result => {
|
||||||
|
if (result && result.success) {
|
||||||
|
alert('All bookmarks have been cleared.');
|
||||||
|
} else {
|
||||||
|
alert('Could not clear bookmarks.');
|
||||||
|
console.error(result.error);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
} else {
|
||||||
|
console.error('Settings API for clearing bookmarks not available.');
|
||||||
|
alert('Could not clear bookmarks. API not found.');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
// Clear home bookmarks button
|
||||||
|
const clearHomeBookmarksBtn = document.getElementById('clearHomeBookmarksBtn');
|
||||||
|
if (clearHomeBookmarksBtn) {
|
||||||
|
clearHomeBookmarksBtn.addEventListener('click', () => {
|
||||||
|
if (window.settingsAPI && window.settingsAPI.clearHomeBookmarks) {
|
||||||
|
window.settingsAPI.clearHomeBookmarks().then(result => {
|
||||||
|
if (result && result.success) {
|
||||||
|
alert('All home bookmarks have been cleared.');
|
||||||
|
} else {
|
||||||
|
alert('Could not clear home bookmarks.');
|
||||||
|
console.error(result.error);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
} else {
|
||||||
|
console.error('Settings API for clearing home bookmarks not available.');
|
||||||
|
alert('Could not clear home bookmarks. API not found.');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
});
|
||||||
@@ -0,0 +1,39 @@
|
|||||||
|
/* steamos.css */
|
||||||
|
|
||||||
|
/* Big Picture Mode inspired UI for SteamOS */
|
||||||
|
body {
|
||||||
|
background-color: #1b2838 !important;
|
||||||
|
color: #c7d5e0 !important;
|
||||||
|
}
|
||||||
|
|
||||||
|
#browser-bar {
|
||||||
|
background-color: #171a21 !important;
|
||||||
|
padding: 10px !important;
|
||||||
|
}
|
||||||
|
|
||||||
|
#nav-buttons button {
|
||||||
|
background-color: #4c6b22 !important;
|
||||||
|
color: white !important;
|
||||||
|
border: none !important;
|
||||||
|
border-radius: 5px !important;
|
||||||
|
font-size: 1.2em !important;
|
||||||
|
padding: 10px 20px !important;
|
||||||
|
margin-right: 10px !important;
|
||||||
|
transition: background-color 0.2s;
|
||||||
|
}
|
||||||
|
|
||||||
|
#nav-buttons button:hover {
|
||||||
|
background-color: #5f862a !important;
|
||||||
|
}
|
||||||
|
|
||||||
|
#url-bar {
|
||||||
|
background-color: #2a475e !important;
|
||||||
|
border: 1px solid #66c0f4 !important;
|
||||||
|
color: white !important;
|
||||||
|
font-size: 1.2em !important;
|
||||||
|
padding: 10px !important;
|
||||||
|
}
|
||||||
|
|
||||||
|
#url-bar::placeholder {
|
||||||
|
color: #c7d5e0;
|
||||||
|
}
|
||||||
@@ -0,0 +1,33 @@
|
|||||||
|
/* style.css */
|
||||||
|
@import 'https://cdn.jsdelivr.net/npm/tailwindcss@2.2.19/dist/tailwind.min.css';
|
||||||
|
|
||||||
|
@font-face {
|
||||||
|
font-family: 'Inter';
|
||||||
|
src: url('../assets/fonts/InterVariable.ttf') format('truetype');
|
||||||
|
}
|
||||||
|
|
||||||
|
/* General styles for the browser UI */
|
||||||
|
body {
|
||||||
|
margin: 0;
|
||||||
|
font-family: 'Inter', -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
|
||||||
|
overflow: hidden; /* Hide scrollbars on the main window */
|
||||||
|
}
|
||||||
|
|
||||||
|
#browser-bar {
|
||||||
|
-webkit-app-region: drag; /* Allows dragging the window from the browser bar */
|
||||||
|
}
|
||||||
|
|
||||||
|
#nav-buttons button, #url-bar {
|
||||||
|
-webkit-app-region: no-drag; /* Prevents dragging from interactive elements */
|
||||||
|
}
|
||||||
|
|
||||||
|
#home-btn {
|
||||||
|
font-size: 16px;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
#webview {
|
||||||
|
height: calc(100vh - 56px); /* Adjust height to fill space below the browser bar */
|
||||||
|
}
|
||||||
@@ -0,0 +1,245 @@
|
|||||||
|
// main.js
|
||||||
|
|
||||||
|
// Modules to control application life and create native browser window
|
||||||
|
const { app, BrowserWindow, ipcMain, session } = require('electron');
|
||||||
|
const { pathToFileURL } = require('url');
|
||||||
|
const path = require('path');
|
||||||
|
const os = require('os');
|
||||||
|
const fs = require('fs');
|
||||||
|
|
||||||
|
|
||||||
|
app.commandLine.appendSwitch('ignore-gpu-blacklist');
|
||||||
|
|
||||||
|
|
||||||
|
if (process.platform === 'win32') {
|
||||||
|
app.commandLine.appendSwitch('disable-gpu-sandbox');
|
||||||
|
|
||||||
|
app.commandLine.appendSwitch('no-sandbox');
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
// Function to check if the application is running on SteamOS
|
||||||
|
const isSteamOS = () => {
|
||||||
|
|
||||||
|
return os.platform() === 'linux' && os.release().includes('steam');
|
||||||
|
};
|
||||||
|
|
||||||
|
// Bookmark management functions
|
||||||
|
const bookmarksPath = path.join(__dirname, 'data', 'bookmarks.json');
|
||||||
|
const homeBookmarksPath = path.join(__dirname, 'data', 'home-bookmarks.json');
|
||||||
|
|
||||||
|
const loadBookmarks = () => {
|
||||||
|
try {
|
||||||
|
if (fs.existsSync(bookmarksPath)) {
|
||||||
|
const data = fs.readFileSync(bookmarksPath, 'utf8');
|
||||||
|
return JSON.parse(data);
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error('Error loading bookmarks:', error);
|
||||||
|
}
|
||||||
|
return { bookmarks: [] };
|
||||||
|
};
|
||||||
|
|
||||||
|
const saveBookmarks = (bookmarksData) => {
|
||||||
|
try {
|
||||||
|
fs.writeFileSync(bookmarksPath, JSON.stringify(bookmarksData, null, 2));
|
||||||
|
return true;
|
||||||
|
} catch (error) {
|
||||||
|
console.error('Error saving bookmarks:', error);
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const loadHomeBookmarks = () => {
|
||||||
|
try {
|
||||||
|
if (fs.existsSync(homeBookmarksPath)) {
|
||||||
|
const data = fs.readFileSync(homeBookmarksPath, 'utf8');
|
||||||
|
return JSON.parse(data);
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error('Error loading home bookmarks:', error);
|
||||||
|
}
|
||||||
|
return { home_bookmarks: [] };
|
||||||
|
};
|
||||||
|
|
||||||
|
const saveHomeBookmarks = (bookmarksData) => {
|
||||||
|
try {
|
||||||
|
fs.writeFileSync(homeBookmarksPath, JSON.stringify(bookmarksData, null, 2));
|
||||||
|
return true;
|
||||||
|
} catch (error) {
|
||||||
|
console.error('Error saving home bookmarks:', error);
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
// IPC handlers for bookmark functionality
|
||||||
|
ipcMain.handle('get-bookmarks', () => {
|
||||||
|
return loadBookmarks();
|
||||||
|
});
|
||||||
|
|
||||||
|
ipcMain.handle('get-home-bookmarks', () => {
|
||||||
|
return loadHomeBookmarks();
|
||||||
|
});
|
||||||
|
|
||||||
|
ipcMain.handle('add-bookmark', (event, bookmark) => {
|
||||||
|
const bookmarksData = loadBookmarks();
|
||||||
|
|
||||||
|
// Check if bookmark already exists
|
||||||
|
const exists = bookmarksData.bookmarks.some(b => b.url === bookmark.url);
|
||||||
|
if (exists) {
|
||||||
|
return { success: false, message: 'Bookmark already exists' };
|
||||||
|
}
|
||||||
|
|
||||||
|
// Add timestamp
|
||||||
|
bookmark.dateAdded = new Date().toISOString();
|
||||||
|
|
||||||
|
bookmarksData.bookmarks.push(bookmark);
|
||||||
|
const saved = saveBookmarks(bookmarksData);
|
||||||
|
|
||||||
|
return { success: saved, message: saved ? 'Bookmark added' : 'Failed to save bookmark' };
|
||||||
|
});
|
||||||
|
|
||||||
|
ipcMain.handle('add-home-bookmark', (event, bookmark) => {
|
||||||
|
const bookmarksData = loadHomeBookmarks();
|
||||||
|
|
||||||
|
// Check if bookmark already exists
|
||||||
|
const exists = bookmarksData.home_bookmarks.some(b => b.url === bookmark.url);
|
||||||
|
if (exists) {
|
||||||
|
return { success: false, message: 'Bookmark already exists' };
|
||||||
|
}
|
||||||
|
|
||||||
|
// Add timestamp
|
||||||
|
bookmark.dateAdded = new Date().toISOString();
|
||||||
|
|
||||||
|
bookmarksData.home_bookmarks.push(bookmark);
|
||||||
|
const saved = saveHomeBookmarks(bookmarksData);
|
||||||
|
|
||||||
|
return { success: saved, message: saved ? 'Bookmark added' : 'Failed to save bookmark' };
|
||||||
|
});
|
||||||
|
|
||||||
|
ipcMain.handle('remove-bookmark', (event, url) => {
|
||||||
|
const bookmarksData = loadBookmarks();
|
||||||
|
const initialLength = bookmarksData.bookmarks.length;
|
||||||
|
|
||||||
|
bookmarksData.bookmarks = bookmarksData.bookmarks.filter(b => b.url !== url);
|
||||||
|
|
||||||
|
if (bookmarksData.bookmarks.length < initialLength) {
|
||||||
|
const saved = saveBookmarks(bookmarksData);
|
||||||
|
return { success: saved, message: saved ? 'Bookmark removed' : 'Failed to save bookmarks' };
|
||||||
|
}
|
||||||
|
|
||||||
|
return { success: false, message: 'Bookmark not found' };
|
||||||
|
});
|
||||||
|
|
||||||
|
ipcMain.handle('remove-home-bookmark', (event, url) => {
|
||||||
|
const bookmarksData = loadHomeBookmarks();
|
||||||
|
const initialLength = bookmarksData.home_bookmarks.length;
|
||||||
|
|
||||||
|
bookmarksData.home_bookmarks = bookmarksData.home_bookmarks.filter(b => b.url !== url);
|
||||||
|
|
||||||
|
if (bookmarksData.home_bookmarks.length < initialLength) {
|
||||||
|
const saved = saveHomeBookmarks(bookmarksData);
|
||||||
|
return { success: saved, message: saved ? 'Bookmark removed' : 'Failed to save bookmarks' };
|
||||||
|
}
|
||||||
|
|
||||||
|
return { success: false, message: 'Bookmark not found' };
|
||||||
|
});
|
||||||
|
|
||||||
|
// Handle clear cookies request from settings page
|
||||||
|
ipcMain.handle('clear-cookies', async (event) => {
|
||||||
|
try {
|
||||||
|
const ses = event.sender.session;
|
||||||
|
await ses.clearStorageData({ storages: ['cookies'] });
|
||||||
|
return { success: true };
|
||||||
|
} catch (error) {
|
||||||
|
console.error('Error clearing cookies:', error);
|
||||||
|
return { success: false, error: error.message };
|
||||||
|
}
|
||||||
|
});
|
||||||
|
// Handle go-home request from settings page to navigate back to home
|
||||||
|
ipcMain.handle('go-home', (event) => {
|
||||||
|
// event.sender is the webContents of the webview
|
||||||
|
const wc = event.sender;
|
||||||
|
const homePath = path.join(__dirname, 'frontend', 'pages', 'home.html');
|
||||||
|
// Convert file path to file:// URL and load in the webview
|
||||||
|
const homeUrl = pathToFileURL(homePath).href;
|
||||||
|
wc.loadURL(homeUrl);
|
||||||
|
return { success: true };
|
||||||
|
});
|
||||||
|
|
||||||
|
// Handle clear bookmarks request from settings page
|
||||||
|
ipcMain.handle('clear-bookmarks', (event) => {
|
||||||
|
try {
|
||||||
|
fs.writeFileSync(bookmarksPath, JSON.stringify({ bookmarks: [] }, null, 2));
|
||||||
|
return { success: true };
|
||||||
|
} catch (error) {
|
||||||
|
console.error('Error clearing bookmarks:', error);
|
||||||
|
return { success: false, error: error.message };
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// Handle clear home bookmarks request from settings page
|
||||||
|
ipcMain.handle('clear-home-bookmarks', (event) => {
|
||||||
|
try {
|
||||||
|
fs.writeFileSync(homeBookmarksPath, JSON.stringify({ home_bookmarks: [] }, null, 2));
|
||||||
|
return { success: true };
|
||||||
|
} catch (error) {
|
||||||
|
console.error('Error clearing home bookmarks:', error);
|
||||||
|
return { success: false, error: error.message };
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
function createWindow() {
|
||||||
|
// Create the browser window.
|
||||||
|
const mainWindow = new BrowserWindow({
|
||||||
|
width: 1280,
|
||||||
|
height: 720,
|
||||||
|
webPreferences: {
|
||||||
|
preload: path.join(__dirname, 'preload.js'),
|
||||||
|
// The webview tag is essential for our browser's core functionality.
|
||||||
|
webviewTag: true,
|
||||||
|
// For security reasons, it's good practice to disable nodeIntegration
|
||||||
|
// and use a preload script to expose specific functionalities.
|
||||||
|
nodeIntegration: false,
|
||||||
|
contextIsolation: true,
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
// Remove default application menu (File, Edit, View)
|
||||||
|
mainWindow.removeMenu();
|
||||||
|
|
||||||
|
// Load the index.html of the app.
|
||||||
|
mainWindow.loadFile('frontend/index.html');
|
||||||
|
|
||||||
|
// Pass the SteamOS status to the renderer process
|
||||||
|
mainWindow.webContents.on('did-finish-load', () => {
|
||||||
|
mainWindow.webContents.send('is-steam-os', isSteamOS());
|
||||||
|
});
|
||||||
|
|
||||||
|
// Open the DevTools.
|
||||||
|
// mainWindow.webContents.openDevTools()
|
||||||
|
}
|
||||||
|
|
||||||
|
// This method will be called when Electron has finished
|
||||||
|
// initialization and is ready to create browser windows.
|
||||||
|
// Some APIs can only be used after this event occurs.
|
||||||
|
app.whenReady().then(() => {
|
||||||
|
createWindow();
|
||||||
|
|
||||||
|
app.on('activate', function () {
|
||||||
|
// On macOS it's common to re-create a window in the app when the
|
||||||
|
// dock icon is clicked and there are no other windows open.
|
||||||
|
if (BrowserWindow.getAllWindows().length === 0) createWindow();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
// Quit when all windows are closed, except on macOS. There, it's common
|
||||||
|
// for applications and their menu bar to stay active until the user quits
|
||||||
|
// explicitly with Cmd + Q.
|
||||||
|
app.on('window-all-closed', function () {
|
||||||
|
if (process.platform !== 'darwin') app.quit();
|
||||||
|
});
|
||||||
|
|
||||||
|
// In this file you can include the rest of your app's specific main process
|
||||||
|
// code. You can also put them in separate files and require them here.
|
||||||
+16
@@ -0,0 +1,16 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
|
||||||
|
|
||||||
|
case `uname` in
|
||||||
|
*CYGWIN*|*MINGW*|*MSYS*)
|
||||||
|
if command -v cygpath > /dev/null 2>&1; then
|
||||||
|
basedir=`cygpath -w "$basedir"`
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
if [ -x "$basedir/node" ]; then
|
||||||
|
exec "$basedir/node" "$basedir/../electron/cli.js" "$@"
|
||||||
|
else
|
||||||
|
exec node "$basedir/../electron/cli.js" "$@"
|
||||||
|
fi
|
||||||
+17
@@ -0,0 +1,17 @@
|
|||||||
|
@ECHO off
|
||||||
|
GOTO start
|
||||||
|
:find_dp0
|
||||||
|
SET dp0=%~dp0
|
||||||
|
EXIT /b
|
||||||
|
:start
|
||||||
|
SETLOCAL
|
||||||
|
CALL :find_dp0
|
||||||
|
|
||||||
|
IF EXIST "%dp0%\node.exe" (
|
||||||
|
SET "_prog=%dp0%\node.exe"
|
||||||
|
) ELSE (
|
||||||
|
SET "_prog=node"
|
||||||
|
SET PATHEXT=%PATHEXT:;.JS;=;%
|
||||||
|
)
|
||||||
|
|
||||||
|
endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%" "%dp0%\..\electron\cli.js" %*
|
||||||
+28
@@ -0,0 +1,28 @@
|
|||||||
|
#!/usr/bin/env pwsh
|
||||||
|
$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
|
||||||
|
|
||||||
|
$exe=""
|
||||||
|
if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
|
||||||
|
# Fix case when both the Windows and Linux builds of Node
|
||||||
|
# are installed in the same directory
|
||||||
|
$exe=".exe"
|
||||||
|
}
|
||||||
|
$ret=0
|
||||||
|
if (Test-Path "$basedir/node$exe") {
|
||||||
|
# Support pipeline input
|
||||||
|
if ($MyInvocation.ExpectingInput) {
|
||||||
|
$input | & "$basedir/node$exe" "$basedir/../electron/cli.js" $args
|
||||||
|
} else {
|
||||||
|
& "$basedir/node$exe" "$basedir/../electron/cli.js" $args
|
||||||
|
}
|
||||||
|
$ret=$LASTEXITCODE
|
||||||
|
} else {
|
||||||
|
# Support pipeline input
|
||||||
|
if ($MyInvocation.ExpectingInput) {
|
||||||
|
$input | & "node$exe" "$basedir/../electron/cli.js" $args
|
||||||
|
} else {
|
||||||
|
& "node$exe" "$basedir/../electron/cli.js" $args
|
||||||
|
}
|
||||||
|
$ret=$LASTEXITCODE
|
||||||
|
}
|
||||||
|
exit $ret
|
||||||
+16
@@ -0,0 +1,16 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
|
||||||
|
|
||||||
|
case `uname` in
|
||||||
|
*CYGWIN*|*MINGW*|*MSYS*)
|
||||||
|
if command -v cygpath > /dev/null 2>&1; then
|
||||||
|
basedir=`cygpath -w "$basedir"`
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
if [ -x "$basedir/node" ]; then
|
||||||
|
exec "$basedir/node" "$basedir/../extract-zip/cli.js" "$@"
|
||||||
|
else
|
||||||
|
exec node "$basedir/../extract-zip/cli.js" "$@"
|
||||||
|
fi
|
||||||
+17
@@ -0,0 +1,17 @@
|
|||||||
|
@ECHO off
|
||||||
|
GOTO start
|
||||||
|
:find_dp0
|
||||||
|
SET dp0=%~dp0
|
||||||
|
EXIT /b
|
||||||
|
:start
|
||||||
|
SETLOCAL
|
||||||
|
CALL :find_dp0
|
||||||
|
|
||||||
|
IF EXIST "%dp0%\node.exe" (
|
||||||
|
SET "_prog=%dp0%\node.exe"
|
||||||
|
) ELSE (
|
||||||
|
SET "_prog=node"
|
||||||
|
SET PATHEXT=%PATHEXT:;.JS;=;%
|
||||||
|
)
|
||||||
|
|
||||||
|
endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%" "%dp0%\..\extract-zip\cli.js" %*
|
||||||
+28
@@ -0,0 +1,28 @@
|
|||||||
|
#!/usr/bin/env pwsh
|
||||||
|
$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
|
||||||
|
|
||||||
|
$exe=""
|
||||||
|
if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
|
||||||
|
# Fix case when both the Windows and Linux builds of Node
|
||||||
|
# are installed in the same directory
|
||||||
|
$exe=".exe"
|
||||||
|
}
|
||||||
|
$ret=0
|
||||||
|
if (Test-Path "$basedir/node$exe") {
|
||||||
|
# Support pipeline input
|
||||||
|
if ($MyInvocation.ExpectingInput) {
|
||||||
|
$input | & "$basedir/node$exe" "$basedir/../extract-zip/cli.js" $args
|
||||||
|
} else {
|
||||||
|
& "$basedir/node$exe" "$basedir/../extract-zip/cli.js" $args
|
||||||
|
}
|
||||||
|
$ret=$LASTEXITCODE
|
||||||
|
} else {
|
||||||
|
# Support pipeline input
|
||||||
|
if ($MyInvocation.ExpectingInput) {
|
||||||
|
$input | & "node$exe" "$basedir/../extract-zip/cli.js" $args
|
||||||
|
} else {
|
||||||
|
& "node$exe" "$basedir/../extract-zip/cli.js" $args
|
||||||
|
}
|
||||||
|
$ret=$LASTEXITCODE
|
||||||
|
}
|
||||||
|
exit $ret
|
||||||
+16
@@ -0,0 +1,16 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
|
||||||
|
|
||||||
|
case `uname` in
|
||||||
|
*CYGWIN*|*MINGW*|*MSYS*)
|
||||||
|
if command -v cygpath > /dev/null 2>&1; then
|
||||||
|
basedir=`cygpath -w "$basedir"`
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
if [ -x "$basedir/node" ]; then
|
||||||
|
exec "$basedir/node" "$basedir/../semver/bin/semver.js" "$@"
|
||||||
|
else
|
||||||
|
exec node "$basedir/../semver/bin/semver.js" "$@"
|
||||||
|
fi
|
||||||
+17
@@ -0,0 +1,17 @@
|
|||||||
|
@ECHO off
|
||||||
|
GOTO start
|
||||||
|
:find_dp0
|
||||||
|
SET dp0=%~dp0
|
||||||
|
EXIT /b
|
||||||
|
:start
|
||||||
|
SETLOCAL
|
||||||
|
CALL :find_dp0
|
||||||
|
|
||||||
|
IF EXIST "%dp0%\node.exe" (
|
||||||
|
SET "_prog=%dp0%\node.exe"
|
||||||
|
) ELSE (
|
||||||
|
SET "_prog=node"
|
||||||
|
SET PATHEXT=%PATHEXT:;.JS;=;%
|
||||||
|
)
|
||||||
|
|
||||||
|
endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%" "%dp0%\..\semver\bin\semver.js" %*
|
||||||
+28
@@ -0,0 +1,28 @@
|
|||||||
|
#!/usr/bin/env pwsh
|
||||||
|
$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
|
||||||
|
|
||||||
|
$exe=""
|
||||||
|
if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
|
||||||
|
# Fix case when both the Windows and Linux builds of Node
|
||||||
|
# are installed in the same directory
|
||||||
|
$exe=".exe"
|
||||||
|
}
|
||||||
|
$ret=0
|
||||||
|
if (Test-Path "$basedir/node$exe") {
|
||||||
|
# Support pipeline input
|
||||||
|
if ($MyInvocation.ExpectingInput) {
|
||||||
|
$input | & "$basedir/node$exe" "$basedir/../semver/bin/semver.js" $args
|
||||||
|
} else {
|
||||||
|
& "$basedir/node$exe" "$basedir/../semver/bin/semver.js" $args
|
||||||
|
}
|
||||||
|
$ret=$LASTEXITCODE
|
||||||
|
} else {
|
||||||
|
# Support pipeline input
|
||||||
|
if ($MyInvocation.ExpectingInput) {
|
||||||
|
$input | & "node$exe" "$basedir/../semver/bin/semver.js" $args
|
||||||
|
} else {
|
||||||
|
& "node$exe" "$basedir/../semver/bin/semver.js" $args
|
||||||
|
}
|
||||||
|
$ret=$LASTEXITCODE
|
||||||
|
}
|
||||||
|
exit $ret
|
||||||
+863
@@ -0,0 +1,863 @@
|
|||||||
|
{
|
||||||
|
"name": "NebulaBrowser",
|
||||||
|
"lockfileVersion": 3,
|
||||||
|
"requires": true,
|
||||||
|
"packages": {
|
||||||
|
"node_modules/@electron/get": {
|
||||||
|
"version": "2.0.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/@electron/get/-/get-2.0.3.tgz",
|
||||||
|
"integrity": "sha512-Qkzpg2s9GnVV2I2BjRksUi43U5e6+zaQMcjoJy0C+C5oxaKl+fmckGDQFtRpZpZV0NQekuZZ+tGz7EA9TVnQtQ==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"debug": "^4.1.1",
|
||||||
|
"env-paths": "^2.2.0",
|
||||||
|
"fs-extra": "^8.1.0",
|
||||||
|
"got": "^11.8.5",
|
||||||
|
"progress": "^2.0.3",
|
||||||
|
"semver": "^6.2.0",
|
||||||
|
"sumchecker": "^3.0.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=12"
|
||||||
|
},
|
||||||
|
"optionalDependencies": {
|
||||||
|
"global-agent": "^3.0.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/@sindresorhus/is": {
|
||||||
|
"version": "4.6.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/@sindresorhus/is/-/is-4.6.0.tgz",
|
||||||
|
"integrity": "sha512-t09vSN3MdfsyCHoFcTRCH/iUtG7OJ0CsjzB8cjAmKc/va/kIgeDI/TxsigdncE/4be734m0cvIYwNaV4i2XqAw==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sindresorhus/is?sponsor=1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/@szmarczak/http-timer": {
|
||||||
|
"version": "4.0.6",
|
||||||
|
"resolved": "https://registry.npmjs.org/@szmarczak/http-timer/-/http-timer-4.0.6.tgz",
|
||||||
|
"integrity": "sha512-4BAffykYOgO+5nzBWYwE3W90sBgLJoUPRWWcL8wlyiM8IB8ipJz3UMJ9KXQd1RKQXpKp8Tutn80HZtWsu2u76w==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"defer-to-connect": "^2.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/@types/cacheable-request": {
|
||||||
|
"version": "6.0.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/@types/cacheable-request/-/cacheable-request-6.0.3.tgz",
|
||||||
|
"integrity": "sha512-IQ3EbTzGxIigb1I3qPZc1rWJnH0BmSKv5QYTalEwweFvyBDLSAe24zP0le/hyi7ecGfZVlIVAg4BZqb8WBwKqw==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"@types/http-cache-semantics": "*",
|
||||||
|
"@types/keyv": "^3.1.4",
|
||||||
|
"@types/node": "*",
|
||||||
|
"@types/responselike": "^1.0.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/@types/http-cache-semantics": {
|
||||||
|
"version": "4.0.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/@types/http-cache-semantics/-/http-cache-semantics-4.0.4.tgz",
|
||||||
|
"integrity": "sha512-1m0bIFVc7eJWyve9S0RnuRgcQqF/Xd5QsUZAZeQFr1Q3/p9JWoQQEqmVy+DPTNpGXwhgIetAoYF8JSc33q29QA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/@types/keyv": {
|
||||||
|
"version": "3.1.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/@types/keyv/-/keyv-3.1.4.tgz",
|
||||||
|
"integrity": "sha512-BQ5aZNSCpj7D6K2ksrRCTmKRLEpnPvWDiLPfoGyhZ++8YtiK9d/3DBKPJgry359X/P1PfruyYwvnvwFjuEiEIg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"@types/node": "*"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/@types/node": {
|
||||||
|
"version": "22.16.5",
|
||||||
|
"resolved": "https://registry.npmjs.org/@types/node/-/node-22.16.5.tgz",
|
||||||
|
"integrity": "sha512-bJFoMATwIGaxxx8VJPeM8TonI8t579oRvgAuT8zFugJsJZgzqv0Fu8Mhp68iecjzG7cnN3mO2dJQ5uUM2EFrgQ==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"undici-types": "~6.21.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/@types/responselike": {
|
||||||
|
"version": "1.0.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/@types/responselike/-/responselike-1.0.3.tgz",
|
||||||
|
"integrity": "sha512-H/+L+UkTV33uf49PH5pCAUBVPNj2nDBXTN+qS1dOwyyg24l3CcicicCA7ca+HMvJBZcFgl5r8e+RR6elsb4Lyw==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"@types/node": "*"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/@types/yauzl": {
|
||||||
|
"version": "2.10.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/@types/yauzl/-/yauzl-2.10.3.tgz",
|
||||||
|
"integrity": "sha512-oJoftv0LSuaDZE3Le4DbKX+KS9G36NzOeSap90UIK0yMA/NhKJhqlSGtNDORNRaIbQfzjXDrQa0ytJ6mNRGz/Q==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true,
|
||||||
|
"dependencies": {
|
||||||
|
"@types/node": "*"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/boolean": {
|
||||||
|
"version": "3.2.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/boolean/-/boolean-3.2.0.tgz",
|
||||||
|
"integrity": "sha512-d0II/GO9uf9lfUHH2BQsjxzRJZBdsjgsBiW4BvhWk/3qoKwQFjIDVN19PfX8F2D/r9PCMTtLWjYVCFrpeYUzsw==",
|
||||||
|
"deprecated": "Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true
|
||||||
|
},
|
||||||
|
"node_modules/buffer-crc32": {
|
||||||
|
"version": "0.2.13",
|
||||||
|
"resolved": "https://registry.npmjs.org/buffer-crc32/-/buffer-crc32-0.2.13.tgz",
|
||||||
|
"integrity": "sha512-VO9Ht/+p3SN7SKWqcrgEzjGbRSJYTx+Q1pTQC0wrWqHx0vpJraQ6GtHx8tvcg1rlK1byhU5gccxgOgj7B0TDkQ==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": "*"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/cacheable-lookup": {
|
||||||
|
"version": "5.0.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/cacheable-lookup/-/cacheable-lookup-5.0.4.tgz",
|
||||||
|
"integrity": "sha512-2/kNscPhpcxrOigMZzbiWF7dz8ilhb/nIHU3EyZiXWXpeq/au8qJ8VhdftMkty3n7Gj6HIGalQG8oiBNB3AJgA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10.6.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/cacheable-request": {
|
||||||
|
"version": "7.0.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/cacheable-request/-/cacheable-request-7.0.4.tgz",
|
||||||
|
"integrity": "sha512-v+p6ongsrp0yTGbJXjgxPow2+DL93DASP4kXCDKb8/bwRtt9OEF3whggkkDkGNzgcWy2XaF4a8nZglC7uElscg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"clone-response": "^1.0.2",
|
||||||
|
"get-stream": "^5.1.0",
|
||||||
|
"http-cache-semantics": "^4.0.0",
|
||||||
|
"keyv": "^4.0.0",
|
||||||
|
"lowercase-keys": "^2.0.0",
|
||||||
|
"normalize-url": "^6.0.1",
|
||||||
|
"responselike": "^2.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/clone-response": {
|
||||||
|
"version": "1.0.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/clone-response/-/clone-response-1.0.3.tgz",
|
||||||
|
"integrity": "sha512-ROoL94jJH2dUVML2Y/5PEDNaSHgeOdSDicUyS7izcF63G6sTc/FTjLub4b8Il9S8S0beOfYt0TaA5qvFK+w0wA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"mimic-response": "^1.0.0"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/debug": {
|
||||||
|
"version": "4.4.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/debug/-/debug-4.4.1.tgz",
|
||||||
|
"integrity": "sha512-KcKCqiftBJcZr++7ykoDIEwSa3XWowTfNPo92BYxjXiyYEVrUQh2aLyhxBCwww+heortUFxEJYcRzosstTEBYQ==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"ms": "^2.1.3"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=6.0"
|
||||||
|
},
|
||||||
|
"peerDependenciesMeta": {
|
||||||
|
"supports-color": {
|
||||||
|
"optional": true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/decompress-response": {
|
||||||
|
"version": "6.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz",
|
||||||
|
"integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"mimic-response": "^3.1.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/decompress-response/node_modules/mimic-response": {
|
||||||
|
"version": "3.1.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz",
|
||||||
|
"integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/defer-to-connect": {
|
||||||
|
"version": "2.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/defer-to-connect/-/defer-to-connect-2.0.1.tgz",
|
||||||
|
"integrity": "sha512-4tvttepXG1VaYGrRibk5EwJd1t4udunSOVMdLSAL6mId1ix438oPwPZMALY41FCijukO1L0twNcGsdzS7dHgDg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/define-data-property": {
|
||||||
|
"version": "1.1.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz",
|
||||||
|
"integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true,
|
||||||
|
"dependencies": {
|
||||||
|
"es-define-property": "^1.0.0",
|
||||||
|
"es-errors": "^1.3.0",
|
||||||
|
"gopd": "^1.0.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/define-properties": {
|
||||||
|
"version": "1.2.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/define-properties/-/define-properties-1.2.1.tgz",
|
||||||
|
"integrity": "sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true,
|
||||||
|
"dependencies": {
|
||||||
|
"define-data-property": "^1.0.1",
|
||||||
|
"has-property-descriptors": "^1.0.0",
|
||||||
|
"object-keys": "^1.1.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/detect-node": {
|
||||||
|
"version": "2.1.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/detect-node/-/detect-node-2.1.0.tgz",
|
||||||
|
"integrity": "sha512-T0NIuQpnTvFDATNuHN5roPwSBG83rFsuO+MXXH9/3N1eFbn4wcPjttvjMLEPWJ0RGUYgQE7cGgS3tNxbqCGM7g==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true
|
||||||
|
},
|
||||||
|
"node_modules/electron": {
|
||||||
|
"version": "37.2.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/electron/-/electron-37.2.4.tgz",
|
||||||
|
"integrity": "sha512-F1WDDvY60TpFwGyW+evNB5q0Em8PamcDTVIKB2NaiaKEbNC2Fabn8Wyxy5g+Anirr1K40eKGjfSJhWEUbI1TOw==",
|
||||||
|
"dev": true,
|
||||||
|
"hasInstallScript": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"@electron/get": "^2.0.0",
|
||||||
|
"@types/node": "^22.7.7",
|
||||||
|
"extract-zip": "^2.0.1"
|
||||||
|
},
|
||||||
|
"bin": {
|
||||||
|
"electron": "cli.js"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 12.20.55"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/end-of-stream": {
|
||||||
|
"version": "1.4.5",
|
||||||
|
"resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.5.tgz",
|
||||||
|
"integrity": "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"once": "^1.4.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/env-paths": {
|
||||||
|
"version": "2.2.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/env-paths/-/env-paths-2.2.1.tgz",
|
||||||
|
"integrity": "sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/es-define-property": {
|
||||||
|
"version": "1.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
|
||||||
|
"integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true,
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/es-errors": {
|
||||||
|
"version": "1.3.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
|
||||||
|
"integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true,
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/es6-error": {
|
||||||
|
"version": "4.1.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/es6-error/-/es6-error-4.1.1.tgz",
|
||||||
|
"integrity": "sha512-Um/+FxMr9CISWh0bi5Zv0iOD+4cFh5qLeks1qhAopKVAJw3drgKbKySikp7wGhDL0HPeaja0P5ULZrxLkniUVg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true
|
||||||
|
},
|
||||||
|
"node_modules/escape-string-regexp": {
|
||||||
|
"version": "4.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
|
||||||
|
"integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true,
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/extract-zip": {
|
||||||
|
"version": "2.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/extract-zip/-/extract-zip-2.0.1.tgz",
|
||||||
|
"integrity": "sha512-GDhU9ntwuKyGXdZBUgTIe+vXnWj0fppUEtMDL0+idd5Sta8TGpHssn/eusA9mrPr9qNDym6SxAYZjNvCn/9RBg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "BSD-2-Clause",
|
||||||
|
"dependencies": {
|
||||||
|
"debug": "^4.1.1",
|
||||||
|
"get-stream": "^5.1.0",
|
||||||
|
"yauzl": "^2.10.0"
|
||||||
|
},
|
||||||
|
"bin": {
|
||||||
|
"extract-zip": "cli.js"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 10.17.0"
|
||||||
|
},
|
||||||
|
"optionalDependencies": {
|
||||||
|
"@types/yauzl": "^2.9.1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/fd-slicer": {
|
||||||
|
"version": "1.1.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/fd-slicer/-/fd-slicer-1.1.0.tgz",
|
||||||
|
"integrity": "sha512-cE1qsB/VwyQozZ+q1dGxR8LBYNZeofhEdUNGSMbQD3Gw2lAzX9Zb3uIU6Ebc/Fmyjo9AWWfnn0AUCHqtevs/8g==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"pend": "~1.2.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/fs-extra": {
|
||||||
|
"version": "8.1.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-8.1.0.tgz",
|
||||||
|
"integrity": "sha512-yhlQgA6mnOJUKOsRUFsgJdQCvkKhcz8tlZG5HBQfReYZy46OwLcY+Zia0mtdHsOo9y/hP+CxMN0TU9QxoOtG4g==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"graceful-fs": "^4.2.0",
|
||||||
|
"jsonfile": "^4.0.0",
|
||||||
|
"universalify": "^0.1.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=6 <7 || >=8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/get-stream": {
|
||||||
|
"version": "5.2.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/get-stream/-/get-stream-5.2.0.tgz",
|
||||||
|
"integrity": "sha512-nBF+F1rAZVCu/p7rjzgA+Yb4lfYXrpl7a6VmJrU8wF9I1CKvP/QwPNZHnOlwbTkY6dvtFIzFMSyQXbLoTQPRpA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"pump": "^3.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=8"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/global-agent": {
|
||||||
|
"version": "3.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/global-agent/-/global-agent-3.0.0.tgz",
|
||||||
|
"integrity": "sha512-PT6XReJ+D07JvGoxQMkT6qji/jVNfX/h364XHZOWeRzy64sSFr+xJ5OX7LI3b4MPQzdL4H8Y8M0xzPpsVMwA8Q==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "BSD-3-Clause",
|
||||||
|
"optional": true,
|
||||||
|
"dependencies": {
|
||||||
|
"boolean": "^3.0.1",
|
||||||
|
"es6-error": "^4.1.1",
|
||||||
|
"matcher": "^3.0.0",
|
||||||
|
"roarr": "^2.15.3",
|
||||||
|
"semver": "^7.3.2",
|
||||||
|
"serialize-error": "^7.0.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/global-agent/node_modules/semver": {
|
||||||
|
"version": "7.7.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/semver/-/semver-7.7.2.tgz",
|
||||||
|
"integrity": "sha512-RF0Fw+rO5AMf9MAyaRXI4AV0Ulj5lMHqVxxdSgiVbixSCXoEmmX/jk0CuJw4+3SqroYO9VoUh+HcuJivvtJemA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "ISC",
|
||||||
|
"optional": true,
|
||||||
|
"bin": {
|
||||||
|
"semver": "bin/semver.js"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/globalthis": {
|
||||||
|
"version": "1.0.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/globalthis/-/globalthis-1.0.4.tgz",
|
||||||
|
"integrity": "sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true,
|
||||||
|
"dependencies": {
|
||||||
|
"define-properties": "^1.2.1",
|
||||||
|
"gopd": "^1.0.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/gopd": {
|
||||||
|
"version": "1.2.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
|
||||||
|
"integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true,
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/got": {
|
||||||
|
"version": "11.8.6",
|
||||||
|
"resolved": "https://registry.npmjs.org/got/-/got-11.8.6.tgz",
|
||||||
|
"integrity": "sha512-6tfZ91bOr7bOXnK7PRDCGBLa1H4U080YHNaAQ2KsMGlLEzRbk44nsZF2E1IeRc3vtJHPVbKCYgdFbaGO2ljd8g==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"@sindresorhus/is": "^4.0.0",
|
||||||
|
"@szmarczak/http-timer": "^4.0.5",
|
||||||
|
"@types/cacheable-request": "^6.0.1",
|
||||||
|
"@types/responselike": "^1.0.0",
|
||||||
|
"cacheable-lookup": "^5.0.3",
|
||||||
|
"cacheable-request": "^7.0.2",
|
||||||
|
"decompress-response": "^6.0.0",
|
||||||
|
"http2-wrapper": "^1.0.0-beta.5.2",
|
||||||
|
"lowercase-keys": "^2.0.0",
|
||||||
|
"p-cancelable": "^2.0.0",
|
||||||
|
"responselike": "^2.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10.19.0"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sindresorhus/got?sponsor=1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/graceful-fs": {
|
||||||
|
"version": "4.2.11",
|
||||||
|
"resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
|
||||||
|
"integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "ISC"
|
||||||
|
},
|
||||||
|
"node_modules/has-property-descriptors": {
|
||||||
|
"version": "1.0.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz",
|
||||||
|
"integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true,
|
||||||
|
"dependencies": {
|
||||||
|
"es-define-property": "^1.0.0"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/http-cache-semantics": {
|
||||||
|
"version": "4.2.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/http-cache-semantics/-/http-cache-semantics-4.2.0.tgz",
|
||||||
|
"integrity": "sha512-dTxcvPXqPvXBQpq5dUr6mEMJX4oIEFv6bwom3FDwKRDsuIjjJGANqhBuoAn9c1RQJIdAKav33ED65E2ys+87QQ==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "BSD-2-Clause"
|
||||||
|
},
|
||||||
|
"node_modules/http2-wrapper": {
|
||||||
|
"version": "1.0.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/http2-wrapper/-/http2-wrapper-1.0.3.tgz",
|
||||||
|
"integrity": "sha512-V+23sDMr12Wnz7iTcDeJr3O6AIxlnvT/bmaAAAP/Xda35C90p9599p0F1eHR/N1KILWSoWVAiOMFjBBXaXSMxg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"quick-lru": "^5.1.1",
|
||||||
|
"resolve-alpn": "^1.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10.19.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/json-buffer": {
|
||||||
|
"version": "3.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz",
|
||||||
|
"integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/json-stringify-safe": {
|
||||||
|
"version": "5.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz",
|
||||||
|
"integrity": "sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "ISC",
|
||||||
|
"optional": true
|
||||||
|
},
|
||||||
|
"node_modules/jsonfile": {
|
||||||
|
"version": "4.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz",
|
||||||
|
"integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optionalDependencies": {
|
||||||
|
"graceful-fs": "^4.1.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/keyv": {
|
||||||
|
"version": "4.5.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz",
|
||||||
|
"integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"json-buffer": "3.0.1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/lowercase-keys": {
|
||||||
|
"version": "2.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/lowercase-keys/-/lowercase-keys-2.0.0.tgz",
|
||||||
|
"integrity": "sha512-tqNXrS78oMOE73NMxK4EMLQsQowWf8jKooH9g7xPavRT706R6bkQJ6DY2Te7QukaZsulxa30wQ7bk0pm4XiHmA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/matcher": {
|
||||||
|
"version": "3.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/matcher/-/matcher-3.0.0.tgz",
|
||||||
|
"integrity": "sha512-OkeDaAZ/bQCxeFAozM55PKcKU0yJMPGifLwV4Qgjitu+5MoAfSQN4lsLJeXZ1b8w0x+/Emda6MZgXS1jvsapng==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true,
|
||||||
|
"dependencies": {
|
||||||
|
"escape-string-regexp": "^4.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/mimic-response": {
|
||||||
|
"version": "1.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-1.0.1.tgz",
|
||||||
|
"integrity": "sha512-j5EctnkH7amfV/q5Hgmoal1g2QHFJRraOtmx0JpIqkxhBhI/lJSl1nMpQ45hVarwNETOoWEimndZ4QK0RHxuxQ==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=4"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/ms": {
|
||||||
|
"version": "2.1.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
|
||||||
|
"integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/normalize-url": {
|
||||||
|
"version": "6.1.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/normalize-url/-/normalize-url-6.1.0.tgz",
|
||||||
|
"integrity": "sha512-DlL+XwOy3NxAQ8xuC0okPgK46iuVNAK01YN7RueYBqqFeGsBjV9XmCAzAdgt+667bCl5kPh9EqKKDwnaPG1I7A==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/object-keys": {
|
||||||
|
"version": "1.1.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz",
|
||||||
|
"integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true,
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/once": {
|
||||||
|
"version": "1.4.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
|
||||||
|
"integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "ISC",
|
||||||
|
"dependencies": {
|
||||||
|
"wrappy": "1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/p-cancelable": {
|
||||||
|
"version": "2.1.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/p-cancelable/-/p-cancelable-2.1.1.tgz",
|
||||||
|
"integrity": "sha512-BZOr3nRQHOntUjTrH8+Lh54smKHoHyur8We1V8DSMVrl5A2malOOwuJRnKRDjSnkoeBh4at6BwEnb5I7Jl31wg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/pend": {
|
||||||
|
"version": "1.2.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/pend/-/pend-1.2.0.tgz",
|
||||||
|
"integrity": "sha512-F3asv42UuXchdzt+xXqfW1OGlVBe+mxa2mqI0pg5yAHZPvFmY3Y6drSf/GQ1A86WgWEN9Kzh/WrgKa6iGcHXLg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/progress": {
|
||||||
|
"version": "2.0.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/progress/-/progress-2.0.3.tgz",
|
||||||
|
"integrity": "sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=0.4.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/pump": {
|
||||||
|
"version": "3.0.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/pump/-/pump-3.0.3.tgz",
|
||||||
|
"integrity": "sha512-todwxLMY7/heScKmntwQG8CXVkWUOdYxIvY2s0VWAAMh/nd8SoYiRaKjlr7+iCs984f2P8zvrfWcDDYVb73NfA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"end-of-stream": "^1.1.0",
|
||||||
|
"once": "^1.3.1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/quick-lru": {
|
||||||
|
"version": "5.1.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/quick-lru/-/quick-lru-5.1.1.tgz",
|
||||||
|
"integrity": "sha512-WuyALRjWPDGtt/wzJiadO5AXY+8hZ80hVpe6MyivgraREW751X3SbhRvG3eLKOYN+8VEvqLcf3wdnt44Z4S4SA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/resolve-alpn": {
|
||||||
|
"version": "1.2.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/resolve-alpn/-/resolve-alpn-1.2.1.tgz",
|
||||||
|
"integrity": "sha512-0a1F4l73/ZFZOakJnQ3FvkJ2+gSTQWz/r2KE5OdDY0TxPm5h4GkqkWWfM47T7HsbnOtcJVEF4epCVy6u7Q3K+g==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/responselike": {
|
||||||
|
"version": "2.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/responselike/-/responselike-2.0.1.tgz",
|
||||||
|
"integrity": "sha512-4gl03wn3hj1HP3yzgdI7d3lCkF95F21Pz4BPGvKHinyQzALR5CapwC8yIi0Rh58DEMQ/SguC03wFj2k0M/mHhw==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"lowercase-keys": "^2.0.0"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/roarr": {
|
||||||
|
"version": "2.15.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/roarr/-/roarr-2.15.4.tgz",
|
||||||
|
"integrity": "sha512-CHhPh+UNHD2GTXNYhPWLnU8ONHdI+5DI+4EYIAOaiD63rHeYlZvyh8P+in5999TTSFgUYuKUAjzRI4mdh/p+2A==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "BSD-3-Clause",
|
||||||
|
"optional": true,
|
||||||
|
"dependencies": {
|
||||||
|
"boolean": "^3.0.1",
|
||||||
|
"detect-node": "^2.0.4",
|
||||||
|
"globalthis": "^1.0.1",
|
||||||
|
"json-stringify-safe": "^5.0.1",
|
||||||
|
"semver-compare": "^1.0.0",
|
||||||
|
"sprintf-js": "^1.1.2"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=8.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/semver": {
|
||||||
|
"version": "6.3.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
|
||||||
|
"integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "ISC",
|
||||||
|
"bin": {
|
||||||
|
"semver": "bin/semver.js"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/semver-compare": {
|
||||||
|
"version": "1.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/semver-compare/-/semver-compare-1.0.0.tgz",
|
||||||
|
"integrity": "sha512-YM3/ITh2MJ5MtzaM429anh+x2jiLVjqILF4m4oyQB18W7Ggea7BfqdH/wGMK7dDiMghv/6WG7znWMwUDzJiXow==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true
|
||||||
|
},
|
||||||
|
"node_modules/serialize-error": {
|
||||||
|
"version": "7.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/serialize-error/-/serialize-error-7.0.1.tgz",
|
||||||
|
"integrity": "sha512-8I8TjW5KMOKsZQTvoxjuSIa7foAwPWGOts+6o7sgjz41/qMD9VQHEDxi6PBvK2l0MXUmqZyNpUK+T2tQaaElvw==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"optional": true,
|
||||||
|
"dependencies": {
|
||||||
|
"type-fest": "^0.13.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/sprintf-js": {
|
||||||
|
"version": "1.1.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.1.3.tgz",
|
||||||
|
"integrity": "sha512-Oo+0REFV59/rz3gfJNKQiBlwfHaSESl1pcGyABQsnnIfWOFt6JNj5gCog2U6MLZ//IGYD+nA8nI+mTShREReaA==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "BSD-3-Clause",
|
||||||
|
"optional": true
|
||||||
|
},
|
||||||
|
"node_modules/sumchecker": {
|
||||||
|
"version": "3.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/sumchecker/-/sumchecker-3.0.1.tgz",
|
||||||
|
"integrity": "sha512-MvjXzkz/BOfyVDkG0oFOtBxHX2u3gKbMHIF/dXblZsgD3BWOFLmHovIpZY7BykJdAjcqRCBi1WYBNdEC9yI7vg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "Apache-2.0",
|
||||||
|
"dependencies": {
|
||||||
|
"debug": "^4.1.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 8.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/type-fest": {
|
||||||
|
"version": "0.13.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.13.1.tgz",
|
||||||
|
"integrity": "sha512-34R7HTnG0XIJcBSn5XhDd7nNFPRcXYRZrBB2O2jdKqYODldSzBAqzsWoZYYvduky73toYS/ESqxPvkDf/F0XMg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "(MIT OR CC0-1.0)",
|
||||||
|
"optional": true,
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/undici-types": {
|
||||||
|
"version": "6.21.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
|
||||||
|
"integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/universalify": {
|
||||||
|
"version": "0.1.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz",
|
||||||
|
"integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 4.0.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/wrappy": {
|
||||||
|
"version": "1.0.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
|
||||||
|
"integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "ISC"
|
||||||
|
},
|
||||||
|
"node_modules/yauzl": {
|
||||||
|
"version": "2.10.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/yauzl/-/yauzl-2.10.0.tgz",
|
||||||
|
"integrity": "sha512-p4a9I6X6nu6IhoGmBqAcbJy1mlC4j27vEPZX9F4L4/vZT3Lyq1VkFHw/V/PUcB9Buo+DG3iHkT0x3Qya58zc3g==",
|
||||||
|
"dev": true,
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"buffer-crc32": "~0.2.3",
|
||||||
|
"fd-slicer": "~1.1.0"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
+21
@@ -0,0 +1,21 @@
|
|||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) Contributors to the Electron project
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE.
|
||||||
+138
@@ -0,0 +1,138 @@
|
|||||||
|
# @electron/get
|
||||||
|
|
||||||
|
> Download Electron release artifacts
|
||||||
|
|
||||||
|
[](https://circleci.com/gh/electron/get)
|
||||||
|
[](https://npm.im/@electron/get)
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
### Simple: Downloading an Electron Binary ZIP
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
import { download } from '@electron/get';
|
||||||
|
|
||||||
|
// NB: Use this syntax within an async function, Node does not have support for
|
||||||
|
// top-level await as of Node 12.
|
||||||
|
const zipFilePath = await download('4.0.4');
|
||||||
|
```
|
||||||
|
|
||||||
|
### Advanced: Downloading a macOS Electron Symbol File
|
||||||
|
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
import { downloadArtifact } from '@electron/get';
|
||||||
|
|
||||||
|
// NB: Use this syntax within an async function, Node does not have support for
|
||||||
|
// top-level await as of Node 12.
|
||||||
|
const zipFilePath = await downloadArtifact({
|
||||||
|
version: '4.0.4',
|
||||||
|
platform: 'darwin',
|
||||||
|
artifactName: 'electron',
|
||||||
|
artifactSuffix: 'symbols',
|
||||||
|
arch: 'x64',
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Specifying a mirror
|
||||||
|
|
||||||
|
To specify another location to download Electron assets from, the following options are
|
||||||
|
available:
|
||||||
|
|
||||||
|
* `mirrorOptions` Object
|
||||||
|
* `mirror` String (optional) - The base URL of the mirror to download from.
|
||||||
|
* `nightlyMirror` String (optional) - The Electron nightly-specific mirror URL.
|
||||||
|
* `customDir` String (optional) - The name of the directory to download from, often scoped by version number.
|
||||||
|
* `customFilename` String (optional) - The name of the asset to download.
|
||||||
|
* `resolveAssetURL` Function (optional) - A function allowing customization of the url used to download the asset.
|
||||||
|
|
||||||
|
Anatomy of a download URL, in terms of `mirrorOptions`:
|
||||||
|
|
||||||
|
```
|
||||||
|
https://github.com/electron/electron/releases/download/v4.0.4/electron-v4.0.4-linux-x64.zip
|
||||||
|
| | | |
|
||||||
|
------------------------------------------------------- -----------------------------
|
||||||
|
| |
|
||||||
|
mirror / nightlyMirror | | customFilename
|
||||||
|
------
|
||||||
|
||
|
||||||
|
customDir
|
||||||
|
```
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
import { download } from '@electron/get';
|
||||||
|
|
||||||
|
const zipFilePath = await download('4.0.4', {
|
||||||
|
mirrorOptions: {
|
||||||
|
mirror: 'https://mirror.example.com/electron/',
|
||||||
|
customDir: 'custom',
|
||||||
|
customFilename: 'unofficial-electron-linux.zip'
|
||||||
|
}
|
||||||
|
});
|
||||||
|
// Will download from https://mirror.example.com/electron/custom/unofficial-electron-linux.zip
|
||||||
|
|
||||||
|
const nightlyZipFilePath = await download('8.0.0-nightly.20190901', {
|
||||||
|
mirrorOptions: {
|
||||||
|
nightlyMirror: 'https://nightly.example.com/',
|
||||||
|
customDir: 'nightlies',
|
||||||
|
customFilename: 'nightly-linux.zip'
|
||||||
|
}
|
||||||
|
});
|
||||||
|
// Will download from https://nightly.example.com/nightlies/nightly-linux.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
`customDir` can have the placeholder `{{ version }}`, which will be replaced by the version
|
||||||
|
specified (without the leading `v`). For example:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
const zipFilePath = await download('4.0.4', {
|
||||||
|
mirrorOptions: {
|
||||||
|
mirror: 'https://mirror.example.com/electron/',
|
||||||
|
customDir: 'version-{{ version }}',
|
||||||
|
platform: 'linux',
|
||||||
|
arch: 'x64'
|
||||||
|
}
|
||||||
|
});
|
||||||
|
// Will download from https://mirror.example.com/electron/version-4.0.4/electron-v4.0.4-linux-x64.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Using environment variables for mirror options
|
||||||
|
Mirror options can also be specified via the following environment variables:
|
||||||
|
* `ELECTRON_CUSTOM_DIR` - Specifies the custom directory to download from.
|
||||||
|
* `ELECTRON_CUSTOM_FILENAME` - Specifies the custom file name to download.
|
||||||
|
* `ELECTRON_MIRROR` - Specifies the URL of the server to download from if the version is not a nightly version.
|
||||||
|
* `ELECTRON_NIGHTLY_MIRROR` - Specifies the URL of the server to download from if the version is a nightly version.
|
||||||
|
|
||||||
|
### Overriding the version downloaded
|
||||||
|
|
||||||
|
The version downloaded can be overriden by setting the `ELECTRON_CUSTOM_VERSION` environment variable.
|
||||||
|
Setting this environment variable will override the version passed in to `download` or `downloadArtifact`.
|
||||||
|
|
||||||
|
## How It Works
|
||||||
|
|
||||||
|
This module downloads Electron to a known place on your system and caches it
|
||||||
|
so that future requests for that asset can be returned instantly. The cache
|
||||||
|
locations are:
|
||||||
|
|
||||||
|
* Linux: `$XDG_CACHE_HOME` or `~/.cache/electron/`
|
||||||
|
* MacOS: `~/Library/Caches/electron/`
|
||||||
|
* Windows: `%LOCALAPPDATA%/electron/Cache` or `~/AppData/Local/electron/Cache/`
|
||||||
|
|
||||||
|
By default, the module uses [`got`](https://github.com/sindresorhus/got) as the
|
||||||
|
downloader. As a result, you can use the same [options](https://github.com/sindresorhus/got#options)
|
||||||
|
via `downloadOptions`.
|
||||||
|
|
||||||
|
### Progress Bar
|
||||||
|
|
||||||
|
By default, a progress bar is shown when downloading an artifact for more than 30 seconds. To
|
||||||
|
disable, set the `ELECTRON_GET_NO_PROGRESS` environment variable to any non-empty value, or set
|
||||||
|
`quiet` to `true` in `downloadOptions`. If you need to monitor progress yourself via the API, set
|
||||||
|
`getProgressCallback` in `downloadOptions`, which has the same function signature as `got`'s
|
||||||
|
[`downloadProgress` event callback](https://github.com/sindresorhus/got#ondownloadprogress-progress).
|
||||||
|
|
||||||
|
### Proxies
|
||||||
|
|
||||||
|
Downstream packages should utilize the `initializeProxy` function to add HTTP(S) proxy support. If
|
||||||
|
the environment variable `ELECTRON_GET_USE_PROXY` is set, it is called automatically.
|
||||||
+8
@@ -0,0 +1,8 @@
|
|||||||
|
export declare class Cache {
|
||||||
|
private cacheRoot;
|
||||||
|
constructor(cacheRoot?: string);
|
||||||
|
static getCacheDirectory(downloadUrl: string): string;
|
||||||
|
getCachePath(downloadUrl: string, fileName: string): string;
|
||||||
|
getPathForFileInCache(url: string, fileName: string): Promise<string | null>;
|
||||||
|
putFileInCache(url: string, currentPath: string, fileName: string): Promise<string>;
|
||||||
|
}
|
||||||
+60
@@ -0,0 +1,60 @@
|
|||||||
|
"use strict";
|
||||||
|
var __rest = (this && this.__rest) || function (s, e) {
|
||||||
|
var t = {};
|
||||||
|
for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
|
||||||
|
t[p] = s[p];
|
||||||
|
if (s != null && typeof Object.getOwnPropertySymbols === "function")
|
||||||
|
for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
|
||||||
|
if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
|
||||||
|
t[p[i]] = s[p[i]];
|
||||||
|
}
|
||||||
|
return t;
|
||||||
|
};
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const debug_1 = require("debug");
|
||||||
|
const env_paths_1 = require("env-paths");
|
||||||
|
const fs = require("fs-extra");
|
||||||
|
const path = require("path");
|
||||||
|
const url = require("url");
|
||||||
|
const crypto = require("crypto");
|
||||||
|
const d = debug_1.default('@electron/get:cache');
|
||||||
|
const defaultCacheRoot = env_paths_1.default('electron', {
|
||||||
|
suffix: '',
|
||||||
|
}).cache;
|
||||||
|
class Cache {
|
||||||
|
constructor(cacheRoot = defaultCacheRoot) {
|
||||||
|
this.cacheRoot = cacheRoot;
|
||||||
|
}
|
||||||
|
static getCacheDirectory(downloadUrl) {
|
||||||
|
const parsedDownloadUrl = url.parse(downloadUrl);
|
||||||
|
// eslint-disable-next-line @typescript-eslint/no-unused-vars
|
||||||
|
const { search, hash, pathname } = parsedDownloadUrl, rest = __rest(parsedDownloadUrl, ["search", "hash", "pathname"]);
|
||||||
|
const strippedUrl = url.format(Object.assign(Object.assign({}, rest), { pathname: path.dirname(pathname || 'electron') }));
|
||||||
|
return crypto
|
||||||
|
.createHash('sha256')
|
||||||
|
.update(strippedUrl)
|
||||||
|
.digest('hex');
|
||||||
|
}
|
||||||
|
getCachePath(downloadUrl, fileName) {
|
||||||
|
return path.resolve(this.cacheRoot, Cache.getCacheDirectory(downloadUrl), fileName);
|
||||||
|
}
|
||||||
|
async getPathForFileInCache(url, fileName) {
|
||||||
|
const cachePath = this.getCachePath(url, fileName);
|
||||||
|
if (await fs.pathExists(cachePath)) {
|
||||||
|
return cachePath;
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
async putFileInCache(url, currentPath, fileName) {
|
||||||
|
const cachePath = this.getCachePath(url, fileName);
|
||||||
|
d(`Moving ${currentPath} to ${cachePath}`);
|
||||||
|
if (await fs.pathExists(cachePath)) {
|
||||||
|
d('* Replacing existing file');
|
||||||
|
await fs.remove(cachePath);
|
||||||
|
}
|
||||||
|
await fs.move(currentPath, cachePath);
|
||||||
|
return cachePath;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.Cache = Cache;
|
||||||
|
//# sourceMappingURL=Cache.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"Cache.js","sourceRoot":"","sources":["../../src/Cache.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,iCAA0B;AAC1B,yCAAiC;AACjC,+BAA+B;AAC/B,6BAA6B;AAC7B,2BAA2B;AAC3B,iCAAiC;AAEjC,MAAM,CAAC,GAAG,eAAK,CAAC,qBAAqB,CAAC,CAAC;AAEvC,MAAM,gBAAgB,GAAG,mBAAQ,CAAC,UAAU,EAAE;IAC5C,MAAM,EAAE,EAAE;CACX,CAAC,CAAC,KAAK,CAAC;AAET,MAAa,KAAK;IAChB,YAAoB,YAAY,gBAAgB;QAA5B,cAAS,GAAT,SAAS,CAAmB;IAAG,CAAC;IAE7C,MAAM,CAAC,iBAAiB,CAAC,WAAmB;QACjD,MAAM,iBAAiB,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACjD,6DAA6D;QAC7D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAc,iBAAiB,EAA7B,gEAA6B,CAAC;QAC9D,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,iCAAM,IAAI,KAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC,IAAG,CAAC;QAE5F,OAAO,MAAM;aACV,UAAU,CAAC,QAAQ,CAAC;aACpB,MAAM,CAAC,WAAW,CAAC;aACnB,MAAM,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAEM,YAAY,CAAC,WAAmB,EAAE,QAAgB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;IACtF,CAAC;IAEM,KAAK,CAAC,qBAAqB,CAAC,GAAW,EAAE,QAAgB;QAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACnD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;YAClC,OAAO,SAAS,CAAC;SAClB;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,GAAW,EAAE,WAAmB,EAAE,QAAgB;QAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACnD,CAAC,CAAC,UAAU,WAAW,OAAO,SAAS,EAAE,CAAC,CAAC;QAC3C,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;YAClC,CAAC,CAAC,2BAA2B,CAAC,CAAC;YAC/B,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;SAC5B;QAED,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAEtC,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAxCD,sBAwCC"}
|
||||||
+3
@@ -0,0 +1,3 @@
|
|||||||
|
export interface Downloader<T> {
|
||||||
|
download(url: string, targetFilePath: string, options: T): Promise<void>;
|
||||||
|
}
|
||||||
+3
@@ -0,0 +1,3 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
//# sourceMappingURL=Downloader.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"Downloader.js","sourceRoot":"","sources":["../../src/Downloader.ts"],"names":[],"mappings":""}
|
||||||
+21
@@ -0,0 +1,21 @@
|
|||||||
|
import { Progress as GotProgress, Options as GotOptions } from 'got';
|
||||||
|
import { Downloader } from './Downloader';
|
||||||
|
/**
|
||||||
|
* See [`got#options`](https://github.com/sindresorhus/got#options) for possible keys/values.
|
||||||
|
*/
|
||||||
|
export declare type GotDownloaderOptions = (GotOptions & {
|
||||||
|
isStream?: true;
|
||||||
|
}) & {
|
||||||
|
/**
|
||||||
|
* if defined, triggers every time `got`'s `downloadProgress` event callback is triggered.
|
||||||
|
*/
|
||||||
|
getProgressCallback?: (progress: GotProgress) => Promise<void>;
|
||||||
|
/**
|
||||||
|
* if `true`, disables the console progress bar (setting the `ELECTRON_GET_NO_PROGRESS`
|
||||||
|
* environment variable to a non-empty value also does this).
|
||||||
|
*/
|
||||||
|
quiet?: boolean;
|
||||||
|
};
|
||||||
|
export declare class GotDownloader implements Downloader<GotDownloaderOptions> {
|
||||||
|
download(url: string, targetFilePath: string, options?: GotDownloaderOptions): Promise<void>;
|
||||||
|
}
|
||||||
+76
@@ -0,0 +1,76 @@
|
|||||||
|
"use strict";
|
||||||
|
var __rest = (this && this.__rest) || function (s, e) {
|
||||||
|
var t = {};
|
||||||
|
for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
|
||||||
|
t[p] = s[p];
|
||||||
|
if (s != null && typeof Object.getOwnPropertySymbols === "function")
|
||||||
|
for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
|
||||||
|
if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
|
||||||
|
t[p[i]] = s[p[i]];
|
||||||
|
}
|
||||||
|
return t;
|
||||||
|
};
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const fs = require("fs-extra");
|
||||||
|
const got_1 = require("got");
|
||||||
|
const path = require("path");
|
||||||
|
const ProgressBar = require("progress");
|
||||||
|
const PROGRESS_BAR_DELAY_IN_SECONDS = 30;
|
||||||
|
class GotDownloader {
|
||||||
|
async download(url, targetFilePath, options) {
|
||||||
|
if (!options) {
|
||||||
|
options = {};
|
||||||
|
}
|
||||||
|
const { quiet, getProgressCallback } = options, gotOptions = __rest(options, ["quiet", "getProgressCallback"]);
|
||||||
|
let downloadCompleted = false;
|
||||||
|
let bar;
|
||||||
|
let progressPercent;
|
||||||
|
let timeout = undefined;
|
||||||
|
await fs.mkdirp(path.dirname(targetFilePath));
|
||||||
|
const writeStream = fs.createWriteStream(targetFilePath);
|
||||||
|
if (!quiet || !process.env.ELECTRON_GET_NO_PROGRESS) {
|
||||||
|
const start = new Date();
|
||||||
|
timeout = setTimeout(() => {
|
||||||
|
if (!downloadCompleted) {
|
||||||
|
bar = new ProgressBar(`Downloading ${path.basename(url)}: [:bar] :percent ETA: :eta seconds `, {
|
||||||
|
curr: progressPercent,
|
||||||
|
total: 100,
|
||||||
|
});
|
||||||
|
// https://github.com/visionmedia/node-progress/issues/159
|
||||||
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
||||||
|
bar.start = start;
|
||||||
|
}
|
||||||
|
}, PROGRESS_BAR_DELAY_IN_SECONDS * 1000);
|
||||||
|
}
|
||||||
|
await new Promise((resolve, reject) => {
|
||||||
|
const downloadStream = got_1.default.stream(url, gotOptions);
|
||||||
|
downloadStream.on('downloadProgress', async (progress) => {
|
||||||
|
progressPercent = progress.percent;
|
||||||
|
if (bar) {
|
||||||
|
bar.update(progress.percent);
|
||||||
|
}
|
||||||
|
if (getProgressCallback) {
|
||||||
|
await getProgressCallback(progress);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
downloadStream.on('error', error => {
|
||||||
|
if (error instanceof got_1.HTTPError && error.response.statusCode === 404) {
|
||||||
|
error.message += ` for ${error.response.url}`;
|
||||||
|
}
|
||||||
|
if (writeStream.destroy) {
|
||||||
|
writeStream.destroy(error);
|
||||||
|
}
|
||||||
|
reject(error);
|
||||||
|
});
|
||||||
|
writeStream.on('error', error => reject(error));
|
||||||
|
writeStream.on('close', () => resolve());
|
||||||
|
downloadStream.pipe(writeStream);
|
||||||
|
});
|
||||||
|
downloadCompleted = true;
|
||||||
|
if (timeout) {
|
||||||
|
clearTimeout(timeout);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.GotDownloader = GotDownloader;
|
||||||
|
//# sourceMappingURL=GotDownloader.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"GotDownloader.js","sourceRoot":"","sources":["../../src/GotDownloader.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,+BAA+B;AAC/B,6BAAqF;AACrF,6BAA6B;AAC7B,wCAAwC;AAIxC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAiBzC,MAAa,aAAa;IACxB,KAAK,CAAC,QAAQ,CACZ,GAAW,EACX,cAAsB,EACtB,OAA8B;QAE9B,IAAI,CAAC,OAAO,EAAE;YACZ,OAAO,GAAG,EAAE,CAAC;SACd;QACD,MAAM,EAAE,KAAK,EAAE,mBAAmB,KAAoB,OAAO,EAAzB,8DAAyB,CAAC;QAC9D,IAAI,iBAAiB,GAAG,KAAK,CAAC;QAC9B,IAAI,GAA4B,CAAC;QACjC,IAAI,eAAuB,CAAC;QAC5B,IAAI,OAAO,GAA+B,SAAS,CAAC;QACpD,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;QAC9C,MAAM,WAAW,GAAG,EAAE,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;QAEzD,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE;YACnD,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;YACzB,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBACxB,IAAI,CAAC,iBAAiB,EAAE;oBACtB,GAAG,GAAG,IAAI,WAAW,CACnB,eAAe,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,sCAAsC,EACvE;wBACE,IAAI,EAAE,eAAe;wBACrB,KAAK,EAAE,GAAG;qBACX,CACF,CAAC;oBACF,0DAA0D;oBAC1D,8DAA8D;oBAC7D,GAAW,CAAC,KAAK,GAAG,KAAK,CAAC;iBAC5B;YACH,CAAC,EAAE,6BAA6B,GAAG,IAAI,CAAC,CAAC;SAC1C;QACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,cAAc,GAAG,aAAG,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YACnD,cAAc,CAAC,EAAE,CAAC,kBAAkB,EAAE,KAAK,EAAC,QAAQ,EAAC,EAAE;gBACrD,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC;gBACnC,IAAI,GAAG,EAAE;oBACP,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;iBAC9B;gBACD,IAAI,mBAAmB,EAAE;oBACvB,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;iBACrC;YACH,CAAC,CAAC,CAAC;YACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjC,IAAI,KAAK,YAAY,eAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,KAAK,GAAG,EAAE;oBACnE,KAAK,CAAC,OAAO,IAAI,QAAQ,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;iBAC/C;gBACD,IAAI,WAAW,CAAC,OAAO,EAAE;oBACvB,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;iBAC5B;gBAED,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAEzC,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,iBAAiB,GAAG,IAAI,CAAC;QACzB,IAAI,OAAO,EAAE;YACX,YAAY,CAAC,OAAO,CAAC,CAAC;SACvB;IACH,CAAC;CACF;AAlED,sCAkEC"}
|
||||||
+4
@@ -0,0 +1,4 @@
|
|||||||
|
import { ElectronArtifactDetails } from './types';
|
||||||
|
export declare function getArtifactFileName(details: ElectronArtifactDetails): string;
|
||||||
|
export declare function getArtifactRemoteURL(details: ElectronArtifactDetails): Promise<string>;
|
||||||
|
export declare function getArtifactVersion(details: ElectronArtifactDetails): string;
|
||||||
+66
@@ -0,0 +1,66 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const utils_1 = require("./utils");
|
||||||
|
const BASE_URL = 'https://github.com/electron/electron/releases/download/';
|
||||||
|
const NIGHTLY_BASE_URL = 'https://github.com/electron/nightlies/releases/download/';
|
||||||
|
function getArtifactFileName(details) {
|
||||||
|
utils_1.ensureIsTruthyString(details, 'artifactName');
|
||||||
|
if (details.isGeneric) {
|
||||||
|
return details.artifactName;
|
||||||
|
}
|
||||||
|
utils_1.ensureIsTruthyString(details, 'arch');
|
||||||
|
utils_1.ensureIsTruthyString(details, 'platform');
|
||||||
|
utils_1.ensureIsTruthyString(details, 'version');
|
||||||
|
return `${[
|
||||||
|
details.artifactName,
|
||||||
|
details.version,
|
||||||
|
details.platform,
|
||||||
|
details.arch,
|
||||||
|
...(details.artifactSuffix ? [details.artifactSuffix] : []),
|
||||||
|
].join('-')}.zip`;
|
||||||
|
}
|
||||||
|
exports.getArtifactFileName = getArtifactFileName;
|
||||||
|
function mirrorVar(name, options, defaultValue) {
|
||||||
|
// Convert camelCase to camel_case for env var reading
|
||||||
|
const snakeName = name.replace(/([a-z])([A-Z])/g, (_, a, b) => `${a}_${b}`).toLowerCase();
|
||||||
|
return (
|
||||||
|
// .npmrc
|
||||||
|
process.env[`npm_config_electron_${name.toLowerCase()}`] ||
|
||||||
|
process.env[`NPM_CONFIG_ELECTRON_${snakeName.toUpperCase()}`] ||
|
||||||
|
process.env[`npm_config_electron_${snakeName}`] ||
|
||||||
|
// package.json
|
||||||
|
process.env[`npm_package_config_electron_${name}`] ||
|
||||||
|
process.env[`npm_package_config_electron_${snakeName.toLowerCase()}`] ||
|
||||||
|
// env
|
||||||
|
process.env[`ELECTRON_${snakeName.toUpperCase()}`] ||
|
||||||
|
options[name] ||
|
||||||
|
defaultValue);
|
||||||
|
}
|
||||||
|
async function getArtifactRemoteURL(details) {
|
||||||
|
const opts = details.mirrorOptions || {};
|
||||||
|
let base = mirrorVar('mirror', opts, BASE_URL);
|
||||||
|
if (details.version.includes('nightly')) {
|
||||||
|
const nightlyDeprecated = mirrorVar('nightly_mirror', opts, '');
|
||||||
|
if (nightlyDeprecated) {
|
||||||
|
base = nightlyDeprecated;
|
||||||
|
console.warn(`nightly_mirror is deprecated, please use nightlyMirror`);
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
base = mirrorVar('nightlyMirror', opts, NIGHTLY_BASE_URL);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const path = mirrorVar('customDir', opts, details.version).replace('{{ version }}', details.version.replace(/^v/, ''));
|
||||||
|
const file = mirrorVar('customFilename', opts, getArtifactFileName(details));
|
||||||
|
// Allow customized download URL resolution.
|
||||||
|
if (opts.resolveAssetURL) {
|
||||||
|
const url = await opts.resolveAssetURL(details);
|
||||||
|
return url;
|
||||||
|
}
|
||||||
|
return `${base}${path}/${file}`;
|
||||||
|
}
|
||||||
|
exports.getArtifactRemoteURL = getArtifactRemoteURL;
|
||||||
|
function getArtifactVersion(details) {
|
||||||
|
return utils_1.normalizeVersion(mirrorVar('customVersion', details.mirrorOptions || {}, details.version));
|
||||||
|
}
|
||||||
|
exports.getArtifactVersion = getArtifactVersion;
|
||||||
|
//# sourceMappingURL=artifact-utils.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"artifact-utils.js","sourceRoot":"","sources":["../../src/artifact-utils.ts"],"names":[],"mappings":"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"}
|
||||||
+3
@@ -0,0 +1,3 @@
|
|||||||
|
import { DownloadOptions } from './types';
|
||||||
|
import { Downloader } from './Downloader';
|
||||||
|
export declare function getDownloaderForSystem(): Promise<Downloader<DownloadOptions>>;
|
||||||
+12
@@ -0,0 +1,12 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
async function getDownloaderForSystem() {
|
||||||
|
// TODO: Resolve the downloader or default to GotDownloader
|
||||||
|
// Current thoughts are a dot-file traversal for something like
|
||||||
|
// ".electron.downloader" which would be a text file with the name of the
|
||||||
|
// npm module to import() and use as the downloader
|
||||||
|
const { GotDownloader } = await Promise.resolve().then(() => require('./GotDownloader'));
|
||||||
|
return new GotDownloader();
|
||||||
|
}
|
||||||
|
exports.getDownloaderForSystem = getDownloaderForSystem;
|
||||||
|
//# sourceMappingURL=downloader-resolver.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"downloader-resolver.js","sourceRoot":"","sources":["../../src/downloader-resolver.ts"],"names":[],"mappings":";;AAGO,KAAK,UAAU,sBAAsB;IAC1C,2DAA2D;IAC3D,+DAA+D;IAC/D,yEAAyE;IACzE,mDAAmD;IACnD,MAAM,EAAE,aAAa,EAAE,GAAG,2CAAa,iBAAiB,EAAC,CAAC;IAC1D,OAAO,IAAI,aAAa,EAAE,CAAC;AAC7B,CAAC;AAPD,wDAOC"}
|
||||||
+18
@@ -0,0 +1,18 @@
|
|||||||
|
import { ElectronDownloadRequestOptions, ElectronPlatformArtifactDetailsWithDefaults } from './types';
|
||||||
|
export { getHostArch } from './utils';
|
||||||
|
export { initializeProxy } from './proxy';
|
||||||
|
export * from './types';
|
||||||
|
/**
|
||||||
|
* Downloads an artifact from an Electron release and returns an absolute path
|
||||||
|
* to the downloaded file.
|
||||||
|
*
|
||||||
|
* @param artifactDetails - The information required to download the artifact
|
||||||
|
*/
|
||||||
|
export declare function downloadArtifact(_artifactDetails: ElectronPlatformArtifactDetailsWithDefaults): Promise<string>;
|
||||||
|
/**
|
||||||
|
* Downloads a specific version of Electron and returns an absolute path to a
|
||||||
|
* ZIP file.
|
||||||
|
*
|
||||||
|
* @param version - The version of Electron you want to download
|
||||||
|
*/
|
||||||
|
export declare function download(version: string, options?: ElectronDownloadRequestOptions): Promise<string>;
|
||||||
+140
@@ -0,0 +1,140 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const debug_1 = require("debug");
|
||||||
|
const fs = require("fs-extra");
|
||||||
|
const path = require("path");
|
||||||
|
const semver = require("semver");
|
||||||
|
const sumchecker = require("sumchecker");
|
||||||
|
const artifact_utils_1 = require("./artifact-utils");
|
||||||
|
const Cache_1 = require("./Cache");
|
||||||
|
const downloader_resolver_1 = require("./downloader-resolver");
|
||||||
|
const proxy_1 = require("./proxy");
|
||||||
|
const utils_1 = require("./utils");
|
||||||
|
var utils_2 = require("./utils");
|
||||||
|
exports.getHostArch = utils_2.getHostArch;
|
||||||
|
var proxy_2 = require("./proxy");
|
||||||
|
exports.initializeProxy = proxy_2.initializeProxy;
|
||||||
|
const d = debug_1.default('@electron/get:index');
|
||||||
|
if (process.env.ELECTRON_GET_USE_PROXY) {
|
||||||
|
proxy_1.initializeProxy();
|
||||||
|
}
|
||||||
|
async function validateArtifact(artifactDetails, downloadedAssetPath, _downloadArtifact) {
|
||||||
|
return await utils_1.withTempDirectoryIn(artifactDetails.tempDirectory, async (tempFolder) => {
|
||||||
|
// Don't try to verify the hash of the hash file itself
|
||||||
|
// and for older versions that don't have a SHASUMS256.txt
|
||||||
|
if (!artifactDetails.artifactName.startsWith('SHASUMS256') &&
|
||||||
|
!artifactDetails.unsafelyDisableChecksums &&
|
||||||
|
semver.gte(artifactDetails.version, '1.3.2')) {
|
||||||
|
let shasumPath;
|
||||||
|
const checksums = artifactDetails.checksums;
|
||||||
|
if (checksums) {
|
||||||
|
shasumPath = path.resolve(tempFolder, 'SHASUMS256.txt');
|
||||||
|
const fileNames = Object.keys(checksums);
|
||||||
|
if (fileNames.length === 0) {
|
||||||
|
throw new Error('Provided "checksums" object is empty, cannot generate a valid SHASUMS256.txt');
|
||||||
|
}
|
||||||
|
const generatedChecksums = fileNames
|
||||||
|
.map(fileName => `${checksums[fileName]} *${fileName}`)
|
||||||
|
.join('\n');
|
||||||
|
await fs.writeFile(shasumPath, generatedChecksums);
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
shasumPath = await _downloadArtifact({
|
||||||
|
isGeneric: true,
|
||||||
|
version: artifactDetails.version,
|
||||||
|
artifactName: 'SHASUMS256.txt',
|
||||||
|
force: artifactDetails.force,
|
||||||
|
downloadOptions: artifactDetails.downloadOptions,
|
||||||
|
cacheRoot: artifactDetails.cacheRoot,
|
||||||
|
downloader: artifactDetails.downloader,
|
||||||
|
mirrorOptions: artifactDetails.mirrorOptions,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
// For versions 1.3.2 - 1.3.4, need to overwrite the `defaultTextEncoding` option:
|
||||||
|
// https://github.com/electron/electron/pull/6676#discussion_r75332120
|
||||||
|
if (semver.satisfies(artifactDetails.version, '1.3.2 - 1.3.4')) {
|
||||||
|
const validatorOptions = {};
|
||||||
|
validatorOptions.defaultTextEncoding = 'binary';
|
||||||
|
const checker = new sumchecker.ChecksumValidator('sha256', shasumPath, validatorOptions);
|
||||||
|
await checker.validate(path.dirname(downloadedAssetPath), path.basename(downloadedAssetPath));
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
await sumchecker('sha256', shasumPath, path.dirname(downloadedAssetPath), [
|
||||||
|
path.basename(downloadedAssetPath),
|
||||||
|
]);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Downloads an artifact from an Electron release and returns an absolute path
|
||||||
|
* to the downloaded file.
|
||||||
|
*
|
||||||
|
* @param artifactDetails - The information required to download the artifact
|
||||||
|
*/
|
||||||
|
async function downloadArtifact(_artifactDetails) {
|
||||||
|
const artifactDetails = Object.assign({}, _artifactDetails);
|
||||||
|
if (!_artifactDetails.isGeneric) {
|
||||||
|
const platformArtifactDetails = artifactDetails;
|
||||||
|
if (!platformArtifactDetails.platform) {
|
||||||
|
d('No platform found, defaulting to the host platform');
|
||||||
|
platformArtifactDetails.platform = process.platform;
|
||||||
|
}
|
||||||
|
if (platformArtifactDetails.arch) {
|
||||||
|
platformArtifactDetails.arch = utils_1.getNodeArch(platformArtifactDetails.arch);
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
d('No arch found, defaulting to the host arch');
|
||||||
|
platformArtifactDetails.arch = utils_1.getHostArch();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
utils_1.ensureIsTruthyString(artifactDetails, 'version');
|
||||||
|
artifactDetails.version = artifact_utils_1.getArtifactVersion(artifactDetails);
|
||||||
|
const fileName = artifact_utils_1.getArtifactFileName(artifactDetails);
|
||||||
|
const url = await artifact_utils_1.getArtifactRemoteURL(artifactDetails);
|
||||||
|
const cache = new Cache_1.Cache(artifactDetails.cacheRoot);
|
||||||
|
// Do not check if the file exists in the cache when force === true
|
||||||
|
if (!artifactDetails.force) {
|
||||||
|
d(`Checking the cache (${artifactDetails.cacheRoot}) for ${fileName} (${url})`);
|
||||||
|
const cachedPath = await cache.getPathForFileInCache(url, fileName);
|
||||||
|
if (cachedPath === null) {
|
||||||
|
d('Cache miss');
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
d('Cache hit');
|
||||||
|
try {
|
||||||
|
await validateArtifact(artifactDetails, cachedPath, downloadArtifact);
|
||||||
|
return cachedPath;
|
||||||
|
}
|
||||||
|
catch (err) {
|
||||||
|
d("Artifact in cache didn't match checksums", err);
|
||||||
|
d('falling back to re-download');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (!artifactDetails.isGeneric &&
|
||||||
|
utils_1.isOfficialLinuxIA32Download(artifactDetails.platform, artifactDetails.arch, artifactDetails.version, artifactDetails.mirrorOptions)) {
|
||||||
|
console.warn('Official Linux/ia32 support is deprecated.');
|
||||||
|
console.warn('For more info: https://electronjs.org/blog/linux-32bit-support');
|
||||||
|
}
|
||||||
|
return await utils_1.withTempDirectoryIn(artifactDetails.tempDirectory, async (tempFolder) => {
|
||||||
|
const tempDownloadPath = path.resolve(tempFolder, artifact_utils_1.getArtifactFileName(artifactDetails));
|
||||||
|
const downloader = artifactDetails.downloader || (await downloader_resolver_1.getDownloaderForSystem());
|
||||||
|
d(`Downloading ${url} to ${tempDownloadPath} with options: ${JSON.stringify(artifactDetails.downloadOptions)}`);
|
||||||
|
await downloader.download(url, tempDownloadPath, artifactDetails.downloadOptions);
|
||||||
|
await validateArtifact(artifactDetails, tempDownloadPath, downloadArtifact);
|
||||||
|
return await cache.putFileInCache(url, tempDownloadPath, fileName);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
exports.downloadArtifact = downloadArtifact;
|
||||||
|
/**
|
||||||
|
* Downloads a specific version of Electron and returns an absolute path to a
|
||||||
|
* ZIP file.
|
||||||
|
*
|
||||||
|
* @param version - The version of Electron you want to download
|
||||||
|
*/
|
||||||
|
function download(version, options) {
|
||||||
|
return downloadArtifact(Object.assign(Object.assign({}, options), { version, platform: process.platform, arch: process.arch, artifactName: 'electron' }));
|
||||||
|
}
|
||||||
|
exports.download = download;
|
||||||
|
//# sourceMappingURL=index.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
|
||||||
+4
@@ -0,0 +1,4 @@
|
|||||||
|
/**
|
||||||
|
* Initializes a third-party proxy module for HTTP(S) requests.
|
||||||
|
*/
|
||||||
|
export declare function initializeProxy(): void;
|
||||||
+27
@@ -0,0 +1,27 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const debug = require("debug");
|
||||||
|
const utils_1 = require("./utils");
|
||||||
|
const d = debug('@electron/get:proxy');
|
||||||
|
/**
|
||||||
|
* Initializes a third-party proxy module for HTTP(S) requests.
|
||||||
|
*/
|
||||||
|
function initializeProxy() {
|
||||||
|
try {
|
||||||
|
// See: https://github.com/electron/get/pull/214#discussion_r798845713
|
||||||
|
const env = utils_1.getEnv('GLOBAL_AGENT_');
|
||||||
|
utils_1.setEnv('GLOBAL_AGENT_HTTP_PROXY', env('HTTP_PROXY'));
|
||||||
|
utils_1.setEnv('GLOBAL_AGENT_HTTPS_PROXY', env('HTTPS_PROXY'));
|
||||||
|
utils_1.setEnv('GLOBAL_AGENT_NO_PROXY', env('NO_PROXY'));
|
||||||
|
/**
|
||||||
|
* TODO: replace global-agent with a hpagent. @BlackHole1
|
||||||
|
* https://github.com/sindresorhus/got/blob/HEAD/documentation/tips.md#proxying
|
||||||
|
*/
|
||||||
|
require('global-agent').bootstrap();
|
||||||
|
}
|
||||||
|
catch (e) {
|
||||||
|
d('Could not load either proxy modules, built-in proxy support not available:', e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.initializeProxy = initializeProxy;
|
||||||
|
//# sourceMappingURL=proxy.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../src/proxy.ts"],"names":[],"mappings":";;AAAA,+BAA+B;AAC/B,mCAAyC;AAEzC,MAAM,CAAC,GAAG,KAAK,CAAC,qBAAqB,CAAC,CAAC;AAEvC;;GAEG;AACH,SAAgB,eAAe;IAC7B,IAAI;QACF,sEAAsE;QACtE,MAAM,GAAG,GAAG,cAAM,CAAC,eAAe,CAAC,CAAC;QAEpC,cAAM,CAAC,yBAAyB,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QACrD,cAAM,CAAC,0BAA0B,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;QACvD,cAAM,CAAC,uBAAuB,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;QAEjD;;;WAGG;QACH,OAAO,CAAC,cAAc,CAAC,CAAC,SAAS,EAAE,CAAC;KACrC;IAAC,OAAO,CAAC,EAAE;QACV,CAAC,CAAC,4EAA4E,EAAE,CAAC,CAAC,CAAC;KACpF;AACH,CAAC;AAjBD,0CAiBC"}
|
||||||
+129
@@ -0,0 +1,129 @@
|
|||||||
|
import { Downloader } from './Downloader';
|
||||||
|
export declare type DownloadOptions = any;
|
||||||
|
export interface MirrorOptions {
|
||||||
|
/**
|
||||||
|
* DEPRECATED - see nightlyMirror.
|
||||||
|
*/
|
||||||
|
nightly_mirror?: string;
|
||||||
|
/**
|
||||||
|
* The Electron nightly-specific mirror URL.
|
||||||
|
*/
|
||||||
|
nightlyMirror?: string;
|
||||||
|
/**
|
||||||
|
* The base URL of the mirror to download from,
|
||||||
|
* e.g https://github.com/electron/electron/releases/download
|
||||||
|
*/
|
||||||
|
mirror?: string;
|
||||||
|
/**
|
||||||
|
* The name of the directory to download from,
|
||||||
|
* often scoped by version number e.g 'v4.0.4'
|
||||||
|
*/
|
||||||
|
customDir?: string;
|
||||||
|
/**
|
||||||
|
* The name of the asset to download,
|
||||||
|
* e.g 'electron-v4.0.4-linux-x64.zip'
|
||||||
|
*/
|
||||||
|
customFilename?: string;
|
||||||
|
/**
|
||||||
|
* The version of the asset to download,
|
||||||
|
* e.g '4.0.4'
|
||||||
|
*/
|
||||||
|
customVersion?: string;
|
||||||
|
/**
|
||||||
|
* A function allowing customization of the url returned
|
||||||
|
* from getArtifactRemoteURL().
|
||||||
|
*/
|
||||||
|
resolveAssetURL?: (opts: DownloadOptions) => Promise<string>;
|
||||||
|
}
|
||||||
|
export interface ElectronDownloadRequest {
|
||||||
|
/**
|
||||||
|
* The version of Electron associated with the artifact.
|
||||||
|
*/
|
||||||
|
version: string;
|
||||||
|
/**
|
||||||
|
* The type of artifact. For example:
|
||||||
|
* * `electron`
|
||||||
|
* * `ffmpeg`
|
||||||
|
*/
|
||||||
|
artifactName: string;
|
||||||
|
}
|
||||||
|
export interface ElectronDownloadRequestOptions {
|
||||||
|
/**
|
||||||
|
* Whether to download an artifact regardless of whether it's in the cache directory.
|
||||||
|
*
|
||||||
|
* Defaults to `false`.
|
||||||
|
*/
|
||||||
|
force?: boolean;
|
||||||
|
/**
|
||||||
|
* When set to `true`, disables checking that the artifact download completed successfully
|
||||||
|
* with the correct payload.
|
||||||
|
*
|
||||||
|
* Defaults to `false`.
|
||||||
|
*/
|
||||||
|
unsafelyDisableChecksums?: boolean;
|
||||||
|
/**
|
||||||
|
* Provides checksums for the artifact as strings.
|
||||||
|
* Can be used if you already know the checksums of the Electron artifact
|
||||||
|
* you are downloading and want to skip the checksum file download
|
||||||
|
* without skipping the checksum validation.
|
||||||
|
*
|
||||||
|
* This should be an object whose keys are the file names of the artifacts and
|
||||||
|
* the values are their respective SHA256 checksums.
|
||||||
|
*/
|
||||||
|
checksums?: Record<string, string>;
|
||||||
|
/**
|
||||||
|
* The directory that caches Electron artifact downloads.
|
||||||
|
*
|
||||||
|
* The default value is dependent upon the host platform:
|
||||||
|
*
|
||||||
|
* * Linux: `$XDG_CACHE_HOME` or `~/.cache/electron/`
|
||||||
|
* * MacOS: `~/Library/Caches/electron/`
|
||||||
|
* * Windows: `%LOCALAPPDATA%/electron/Cache` or `~/AppData/Local/electron/Cache/`
|
||||||
|
*/
|
||||||
|
cacheRoot?: string;
|
||||||
|
/**
|
||||||
|
* Options passed to the downloader module.
|
||||||
|
*/
|
||||||
|
downloadOptions?: DownloadOptions;
|
||||||
|
/**
|
||||||
|
* Options related to specifying an artifact mirror.
|
||||||
|
*/
|
||||||
|
mirrorOptions?: MirrorOptions;
|
||||||
|
/**
|
||||||
|
* The custom [[Downloader]] class used to download artifacts. Defaults to the
|
||||||
|
* built-in [[GotDownloader]].
|
||||||
|
*/
|
||||||
|
downloader?: Downloader<DownloadOptions>;
|
||||||
|
/**
|
||||||
|
* A temporary directory for downloads.
|
||||||
|
* It is used before artifacts are put into cache.
|
||||||
|
*/
|
||||||
|
tempDirectory?: string;
|
||||||
|
}
|
||||||
|
export declare type ElectronPlatformArtifactDetails = {
|
||||||
|
/**
|
||||||
|
* The target artifact platform. These are Node-style platform names, for example:
|
||||||
|
* * `win32`
|
||||||
|
* * `darwin`
|
||||||
|
* * `linux`
|
||||||
|
*/
|
||||||
|
platform: string;
|
||||||
|
/**
|
||||||
|
* The target artifact architecture. These are Node-style architecture names, for example:
|
||||||
|
* * `ia32`
|
||||||
|
* * `x64`
|
||||||
|
* * `armv7l`
|
||||||
|
*/
|
||||||
|
arch: string;
|
||||||
|
artifactSuffix?: string;
|
||||||
|
isGeneric?: false;
|
||||||
|
} & ElectronDownloadRequest & ElectronDownloadRequestOptions;
|
||||||
|
export declare type ElectronGenericArtifactDetails = {
|
||||||
|
isGeneric: true;
|
||||||
|
} & ElectronDownloadRequest & ElectronDownloadRequestOptions;
|
||||||
|
export declare type ElectronArtifactDetails = ElectronPlatformArtifactDetails | ElectronGenericArtifactDetails;
|
||||||
|
export declare type Omit<T, K> = Pick<T, Exclude<keyof T, K>>;
|
||||||
|
export declare type ElectronPlatformArtifactDetailsWithDefaults = (Omit<ElectronPlatformArtifactDetails, 'platform' | 'arch'> & {
|
||||||
|
platform?: string;
|
||||||
|
arch?: string;
|
||||||
|
}) | ElectronGenericArtifactDetails;
|
||||||
+3
@@ -0,0 +1,3 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
//# sourceMappingURL=types.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}
|
||||||
+25
@@ -0,0 +1,25 @@
|
|||||||
|
export declare function withTempDirectoryIn<T>(parentDirectory: string | undefined, fn: (directory: string) => Promise<T>): Promise<T>;
|
||||||
|
export declare function withTempDirectory<T>(fn: (directory: string) => Promise<T>): Promise<T>;
|
||||||
|
export declare function normalizeVersion(version: string): string;
|
||||||
|
/**
|
||||||
|
* Runs the `uname` command and returns the trimmed output.
|
||||||
|
*/
|
||||||
|
export declare function uname(): string;
|
||||||
|
/**
|
||||||
|
* Generates an architecture name that would be used in an Electron or Node.js
|
||||||
|
* download file name.
|
||||||
|
*/
|
||||||
|
export declare function getNodeArch(arch: string): string;
|
||||||
|
/**
|
||||||
|
* Generates an architecture name that would be used in an Electron or Node.js
|
||||||
|
* download file name, from the `process` module information.
|
||||||
|
*/
|
||||||
|
export declare function getHostArch(): string;
|
||||||
|
export declare function ensureIsTruthyString<T, K extends keyof T>(obj: T, key: K): void;
|
||||||
|
export declare function isOfficialLinuxIA32Download(platform: string, arch: string, version: string, mirrorOptions?: object): boolean;
|
||||||
|
/**
|
||||||
|
* Find the value of a environment variable which may or may not have the
|
||||||
|
* prefix, in a case-insensitive manner.
|
||||||
|
*/
|
||||||
|
export declare function getEnv(prefix?: string): (name: string) => string | undefined;
|
||||||
|
export declare function setEnv(key: string, value: string | undefined): void;
|
||||||
+107
@@ -0,0 +1,107 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const childProcess = require("child_process");
|
||||||
|
const fs = require("fs-extra");
|
||||||
|
const os = require("os");
|
||||||
|
const path = require("path");
|
||||||
|
async function useAndRemoveDirectory(directory, fn) {
|
||||||
|
let result;
|
||||||
|
try {
|
||||||
|
result = await fn(directory);
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
await fs.remove(directory);
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
async function withTempDirectoryIn(parentDirectory = os.tmpdir(), fn) {
|
||||||
|
const tempDirectoryPrefix = 'electron-download-';
|
||||||
|
const tempDirectory = await fs.mkdtemp(path.resolve(parentDirectory, tempDirectoryPrefix));
|
||||||
|
return useAndRemoveDirectory(tempDirectory, fn);
|
||||||
|
}
|
||||||
|
exports.withTempDirectoryIn = withTempDirectoryIn;
|
||||||
|
async function withTempDirectory(fn) {
|
||||||
|
return withTempDirectoryIn(undefined, fn);
|
||||||
|
}
|
||||||
|
exports.withTempDirectory = withTempDirectory;
|
||||||
|
function normalizeVersion(version) {
|
||||||
|
if (!version.startsWith('v')) {
|
||||||
|
return `v${version}`;
|
||||||
|
}
|
||||||
|
return version;
|
||||||
|
}
|
||||||
|
exports.normalizeVersion = normalizeVersion;
|
||||||
|
/**
|
||||||
|
* Runs the `uname` command and returns the trimmed output.
|
||||||
|
*/
|
||||||
|
function uname() {
|
||||||
|
return childProcess
|
||||||
|
.execSync('uname -m')
|
||||||
|
.toString()
|
||||||
|
.trim();
|
||||||
|
}
|
||||||
|
exports.uname = uname;
|
||||||
|
/**
|
||||||
|
* Generates an architecture name that would be used in an Electron or Node.js
|
||||||
|
* download file name.
|
||||||
|
*/
|
||||||
|
function getNodeArch(arch) {
|
||||||
|
if (arch === 'arm') {
|
||||||
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
||||||
|
switch (process.config.variables.arm_version) {
|
||||||
|
case '6':
|
||||||
|
return uname();
|
||||||
|
case '7':
|
||||||
|
default:
|
||||||
|
return 'armv7l';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return arch;
|
||||||
|
}
|
||||||
|
exports.getNodeArch = getNodeArch;
|
||||||
|
/**
|
||||||
|
* Generates an architecture name that would be used in an Electron or Node.js
|
||||||
|
* download file name, from the `process` module information.
|
||||||
|
*/
|
||||||
|
function getHostArch() {
|
||||||
|
return getNodeArch(process.arch);
|
||||||
|
}
|
||||||
|
exports.getHostArch = getHostArch;
|
||||||
|
function ensureIsTruthyString(obj, key) {
|
||||||
|
if (!obj[key] || typeof obj[key] !== 'string') {
|
||||||
|
throw new Error(`Expected property "${key}" to be provided as a string but it was not`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.ensureIsTruthyString = ensureIsTruthyString;
|
||||||
|
function isOfficialLinuxIA32Download(platform, arch, version, mirrorOptions) {
|
||||||
|
return (platform === 'linux' &&
|
||||||
|
arch === 'ia32' &&
|
||||||
|
Number(version.slice(1).split('.')[0]) >= 4 &&
|
||||||
|
typeof mirrorOptions === 'undefined');
|
||||||
|
}
|
||||||
|
exports.isOfficialLinuxIA32Download = isOfficialLinuxIA32Download;
|
||||||
|
/**
|
||||||
|
* Find the value of a environment variable which may or may not have the
|
||||||
|
* prefix, in a case-insensitive manner.
|
||||||
|
*/
|
||||||
|
function getEnv(prefix = '') {
|
||||||
|
const envsLowerCase = {};
|
||||||
|
for (const envKey in process.env) {
|
||||||
|
envsLowerCase[envKey.toLowerCase()] = process.env[envKey];
|
||||||
|
}
|
||||||
|
return (name) => {
|
||||||
|
return (envsLowerCase[`${prefix}${name}`.toLowerCase()] ||
|
||||||
|
envsLowerCase[name.toLowerCase()] ||
|
||||||
|
undefined);
|
||||||
|
};
|
||||||
|
}
|
||||||
|
exports.getEnv = getEnv;
|
||||||
|
function setEnv(key, value) {
|
||||||
|
// The `void` operator always returns `undefined`.
|
||||||
|
// See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/void
|
||||||
|
if (value !== void 0) {
|
||||||
|
process.env[key] = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.setEnv = setEnv;
|
||||||
|
//# sourceMappingURL=utils.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"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"}
|
||||||
+8
@@ -0,0 +1,8 @@
|
|||||||
|
export declare class Cache {
|
||||||
|
private cacheRoot;
|
||||||
|
constructor(cacheRoot?: string);
|
||||||
|
static getCacheDirectory(downloadUrl: string): string;
|
||||||
|
getCachePath(downloadUrl: string, fileName: string): string;
|
||||||
|
getPathForFileInCache(url: string, fileName: string): Promise<string | null>;
|
||||||
|
putFileInCache(url: string, currentPath: string, fileName: string): Promise<string>;
|
||||||
|
}
|
||||||
+57
@@ -0,0 +1,57 @@
|
|||||||
|
var __rest = (this && this.__rest) || function (s, e) {
|
||||||
|
var t = {};
|
||||||
|
for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
|
||||||
|
t[p] = s[p];
|
||||||
|
if (s != null && typeof Object.getOwnPropertySymbols === "function")
|
||||||
|
for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
|
||||||
|
if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
|
||||||
|
t[p[i]] = s[p[i]];
|
||||||
|
}
|
||||||
|
return t;
|
||||||
|
};
|
||||||
|
import debug from 'debug';
|
||||||
|
import envPaths from 'env-paths';
|
||||||
|
import * as fs from 'fs-extra';
|
||||||
|
import * as path from 'path';
|
||||||
|
import * as url from 'url';
|
||||||
|
import * as crypto from 'crypto';
|
||||||
|
const d = debug('@electron/get:cache');
|
||||||
|
const defaultCacheRoot = envPaths('electron', {
|
||||||
|
suffix: '',
|
||||||
|
}).cache;
|
||||||
|
export class Cache {
|
||||||
|
constructor(cacheRoot = defaultCacheRoot) {
|
||||||
|
this.cacheRoot = cacheRoot;
|
||||||
|
}
|
||||||
|
static getCacheDirectory(downloadUrl) {
|
||||||
|
const parsedDownloadUrl = url.parse(downloadUrl);
|
||||||
|
// eslint-disable-next-line @typescript-eslint/no-unused-vars
|
||||||
|
const { search, hash, pathname } = parsedDownloadUrl, rest = __rest(parsedDownloadUrl, ["search", "hash", "pathname"]);
|
||||||
|
const strippedUrl = url.format(Object.assign(Object.assign({}, rest), { pathname: path.dirname(pathname || 'electron') }));
|
||||||
|
return crypto
|
||||||
|
.createHash('sha256')
|
||||||
|
.update(strippedUrl)
|
||||||
|
.digest('hex');
|
||||||
|
}
|
||||||
|
getCachePath(downloadUrl, fileName) {
|
||||||
|
return path.resolve(this.cacheRoot, Cache.getCacheDirectory(downloadUrl), fileName);
|
||||||
|
}
|
||||||
|
async getPathForFileInCache(url, fileName) {
|
||||||
|
const cachePath = this.getCachePath(url, fileName);
|
||||||
|
if (await fs.pathExists(cachePath)) {
|
||||||
|
return cachePath;
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
async putFileInCache(url, currentPath, fileName) {
|
||||||
|
const cachePath = this.getCachePath(url, fileName);
|
||||||
|
d(`Moving ${currentPath} to ${cachePath}`);
|
||||||
|
if (await fs.pathExists(cachePath)) {
|
||||||
|
d('* Replacing existing file');
|
||||||
|
await fs.remove(cachePath);
|
||||||
|
}
|
||||||
|
await fs.move(currentPath, cachePath);
|
||||||
|
return cachePath;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=Cache.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"Cache.js","sourceRoot":"","sources":["../../src/Cache.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAC3B,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,MAAM,CAAC,GAAG,KAAK,CAAC,qBAAqB,CAAC,CAAC;AAEvC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,UAAU,EAAE;IAC5C,MAAM,EAAE,EAAE;CACX,CAAC,CAAC,KAAK,CAAC;AAET,MAAM,OAAO,KAAK;IAChB,YAAoB,YAAY,gBAAgB;QAA5B,cAAS,GAAT,SAAS,CAAmB;IAAG,CAAC;IAE7C,MAAM,CAAC,iBAAiB,CAAC,WAAmB;QACjD,MAAM,iBAAiB,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACjD,6DAA6D;QAC7D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAc,iBAAiB,EAA7B,gEAA6B,CAAC;QAC9D,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,iCAAM,IAAI,KAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC,IAAG,CAAC;QAE5F,OAAO,MAAM;aACV,UAAU,CAAC,QAAQ,CAAC;aACpB,MAAM,CAAC,WAAW,CAAC;aACnB,MAAM,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAEM,YAAY,CAAC,WAAmB,EAAE,QAAgB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;IACtF,CAAC;IAEM,KAAK,CAAC,qBAAqB,CAAC,GAAW,EAAE,QAAgB;QAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACnD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;YAClC,OAAO,SAAS,CAAC;SAClB;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,GAAW,EAAE,WAAmB,EAAE,QAAgB;QAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACnD,CAAC,CAAC,UAAU,WAAW,OAAO,SAAS,EAAE,CAAC,CAAC;QAC3C,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;YAClC,CAAC,CAAC,2BAA2B,CAAC,CAAC;YAC/B,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;SAC5B;QAED,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAEtC,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}
|
||||||
+3
@@ -0,0 +1,3 @@
|
|||||||
|
export interface Downloader<T> {
|
||||||
|
download(url: string, targetFilePath: string, options: T): Promise<void>;
|
||||||
|
}
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
//# sourceMappingURL=Downloader.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"Downloader.js","sourceRoot":"","sources":["../../src/Downloader.ts"],"names":[],"mappings":""}
|
||||||
+21
@@ -0,0 +1,21 @@
|
|||||||
|
import { Progress as GotProgress, Options as GotOptions } from 'got';
|
||||||
|
import { Downloader } from './Downloader';
|
||||||
|
/**
|
||||||
|
* See [`got#options`](https://github.com/sindresorhus/got#options) for possible keys/values.
|
||||||
|
*/
|
||||||
|
export declare type GotDownloaderOptions = (GotOptions & {
|
||||||
|
isStream?: true;
|
||||||
|
}) & {
|
||||||
|
/**
|
||||||
|
* if defined, triggers every time `got`'s `downloadProgress` event callback is triggered.
|
||||||
|
*/
|
||||||
|
getProgressCallback?: (progress: GotProgress) => Promise<void>;
|
||||||
|
/**
|
||||||
|
* if `true`, disables the console progress bar (setting the `ELECTRON_GET_NO_PROGRESS`
|
||||||
|
* environment variable to a non-empty value also does this).
|
||||||
|
*/
|
||||||
|
quiet?: boolean;
|
||||||
|
};
|
||||||
|
export declare class GotDownloader implements Downloader<GotDownloaderOptions> {
|
||||||
|
download(url: string, targetFilePath: string, options?: GotDownloaderOptions): Promise<void>;
|
||||||
|
}
|
||||||
+73
@@ -0,0 +1,73 @@
|
|||||||
|
var __rest = (this && this.__rest) || function (s, e) {
|
||||||
|
var t = {};
|
||||||
|
for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
|
||||||
|
t[p] = s[p];
|
||||||
|
if (s != null && typeof Object.getOwnPropertySymbols === "function")
|
||||||
|
for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
|
||||||
|
if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
|
||||||
|
t[p[i]] = s[p[i]];
|
||||||
|
}
|
||||||
|
return t;
|
||||||
|
};
|
||||||
|
import * as fs from 'fs-extra';
|
||||||
|
import got, { HTTPError } from 'got';
|
||||||
|
import * as path from 'path';
|
||||||
|
import * as ProgressBar from 'progress';
|
||||||
|
const PROGRESS_BAR_DELAY_IN_SECONDS = 30;
|
||||||
|
export class GotDownloader {
|
||||||
|
async download(url, targetFilePath, options) {
|
||||||
|
if (!options) {
|
||||||
|
options = {};
|
||||||
|
}
|
||||||
|
const { quiet, getProgressCallback } = options, gotOptions = __rest(options, ["quiet", "getProgressCallback"]);
|
||||||
|
let downloadCompleted = false;
|
||||||
|
let bar;
|
||||||
|
let progressPercent;
|
||||||
|
let timeout = undefined;
|
||||||
|
await fs.mkdirp(path.dirname(targetFilePath));
|
||||||
|
const writeStream = fs.createWriteStream(targetFilePath);
|
||||||
|
if (!quiet || !process.env.ELECTRON_GET_NO_PROGRESS) {
|
||||||
|
const start = new Date();
|
||||||
|
timeout = setTimeout(() => {
|
||||||
|
if (!downloadCompleted) {
|
||||||
|
bar = new ProgressBar(`Downloading ${path.basename(url)}: [:bar] :percent ETA: :eta seconds `, {
|
||||||
|
curr: progressPercent,
|
||||||
|
total: 100,
|
||||||
|
});
|
||||||
|
// https://github.com/visionmedia/node-progress/issues/159
|
||||||
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
||||||
|
bar.start = start;
|
||||||
|
}
|
||||||
|
}, PROGRESS_BAR_DELAY_IN_SECONDS * 1000);
|
||||||
|
}
|
||||||
|
await new Promise((resolve, reject) => {
|
||||||
|
const downloadStream = got.stream(url, gotOptions);
|
||||||
|
downloadStream.on('downloadProgress', async (progress) => {
|
||||||
|
progressPercent = progress.percent;
|
||||||
|
if (bar) {
|
||||||
|
bar.update(progress.percent);
|
||||||
|
}
|
||||||
|
if (getProgressCallback) {
|
||||||
|
await getProgressCallback(progress);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
downloadStream.on('error', error => {
|
||||||
|
if (error instanceof HTTPError && error.response.statusCode === 404) {
|
||||||
|
error.message += ` for ${error.response.url}`;
|
||||||
|
}
|
||||||
|
if (writeStream.destroy) {
|
||||||
|
writeStream.destroy(error);
|
||||||
|
}
|
||||||
|
reject(error);
|
||||||
|
});
|
||||||
|
writeStream.on('error', error => reject(error));
|
||||||
|
writeStream.on('close', () => resolve());
|
||||||
|
downloadStream.pipe(writeStream);
|
||||||
|
});
|
||||||
|
downloadCompleted = true;
|
||||||
|
if (timeout) {
|
||||||
|
clearTimeout(timeout);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=GotDownloader.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"GotDownloader.js","sourceRoot":"","sources":["../../src/GotDownloader.ts"],"names":[],"mappings":"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"}
|
||||||
+4
@@ -0,0 +1,4 @@
|
|||||||
|
import { ElectronArtifactDetails } from './types';
|
||||||
|
export declare function getArtifactFileName(details: ElectronArtifactDetails): string;
|
||||||
|
export declare function getArtifactRemoteURL(details: ElectronArtifactDetails): Promise<string>;
|
||||||
|
export declare function getArtifactVersion(details: ElectronArtifactDetails): string;
|
||||||
+61
@@ -0,0 +1,61 @@
|
|||||||
|
import { ensureIsTruthyString, normalizeVersion } from './utils';
|
||||||
|
const BASE_URL = 'https://github.com/electron/electron/releases/download/';
|
||||||
|
const NIGHTLY_BASE_URL = 'https://github.com/electron/nightlies/releases/download/';
|
||||||
|
export function getArtifactFileName(details) {
|
||||||
|
ensureIsTruthyString(details, 'artifactName');
|
||||||
|
if (details.isGeneric) {
|
||||||
|
return details.artifactName;
|
||||||
|
}
|
||||||
|
ensureIsTruthyString(details, 'arch');
|
||||||
|
ensureIsTruthyString(details, 'platform');
|
||||||
|
ensureIsTruthyString(details, 'version');
|
||||||
|
return `${[
|
||||||
|
details.artifactName,
|
||||||
|
details.version,
|
||||||
|
details.platform,
|
||||||
|
details.arch,
|
||||||
|
...(details.artifactSuffix ? [details.artifactSuffix] : []),
|
||||||
|
].join('-')}.zip`;
|
||||||
|
}
|
||||||
|
function mirrorVar(name, options, defaultValue) {
|
||||||
|
// Convert camelCase to camel_case for env var reading
|
||||||
|
const snakeName = name.replace(/([a-z])([A-Z])/g, (_, a, b) => `${a}_${b}`).toLowerCase();
|
||||||
|
return (
|
||||||
|
// .npmrc
|
||||||
|
process.env[`npm_config_electron_${name.toLowerCase()}`] ||
|
||||||
|
process.env[`NPM_CONFIG_ELECTRON_${snakeName.toUpperCase()}`] ||
|
||||||
|
process.env[`npm_config_electron_${snakeName}`] ||
|
||||||
|
// package.json
|
||||||
|
process.env[`npm_package_config_electron_${name}`] ||
|
||||||
|
process.env[`npm_package_config_electron_${snakeName.toLowerCase()}`] ||
|
||||||
|
// env
|
||||||
|
process.env[`ELECTRON_${snakeName.toUpperCase()}`] ||
|
||||||
|
options[name] ||
|
||||||
|
defaultValue);
|
||||||
|
}
|
||||||
|
export async function getArtifactRemoteURL(details) {
|
||||||
|
const opts = details.mirrorOptions || {};
|
||||||
|
let base = mirrorVar('mirror', opts, BASE_URL);
|
||||||
|
if (details.version.includes('nightly')) {
|
||||||
|
const nightlyDeprecated = mirrorVar('nightly_mirror', opts, '');
|
||||||
|
if (nightlyDeprecated) {
|
||||||
|
base = nightlyDeprecated;
|
||||||
|
console.warn(`nightly_mirror is deprecated, please use nightlyMirror`);
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
base = mirrorVar('nightlyMirror', opts, NIGHTLY_BASE_URL);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const path = mirrorVar('customDir', opts, details.version).replace('{{ version }}', details.version.replace(/^v/, ''));
|
||||||
|
const file = mirrorVar('customFilename', opts, getArtifactFileName(details));
|
||||||
|
// Allow customized download URL resolution.
|
||||||
|
if (opts.resolveAssetURL) {
|
||||||
|
const url = await opts.resolveAssetURL(details);
|
||||||
|
return url;
|
||||||
|
}
|
||||||
|
return `${base}${path}/${file}`;
|
||||||
|
}
|
||||||
|
export function getArtifactVersion(details) {
|
||||||
|
return normalizeVersion(mirrorVar('customVersion', details.mirrorOptions || {}, details.version));
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=artifact-utils.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"artifact-utils.js","sourceRoot":"","sources":["../../src/artifact-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEjE,MAAM,QAAQ,GAAG,yDAAyD,CAAC;AAC3E,MAAM,gBAAgB,GAAG,0DAA0D,CAAC;AAEpF,MAAM,UAAU,mBAAmB,CAAC,OAAgC;IAClE,oBAAoB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAE9C,IAAI,OAAO,CAAC,SAAS,EAAE;QACrB,OAAO,OAAO,CAAC,YAAY,CAAC;KAC7B;IAED,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACtC,oBAAoB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1C,oBAAoB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAEzC,OAAO,GAAG;QACR,OAAO,CAAC,YAAY;QACpB,OAAO,CAAC,OAAO;QACf,OAAO,CAAC,QAAQ;QAChB,OAAO,CAAC,IAAI;QACZ,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;AACpB,CAAC;AAED,SAAS,SAAS,CAChB,IAAkD,EAClD,OAAsB,EACtB,YAAoB;IAEpB,sDAAsD;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAE1F,OAAO;IACL,SAAS;IACT,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,uBAAuB,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,uBAAuB,SAAS,EAAE,CAAC;QAC/C,eAAe;QACf,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,EAAE,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,+BAA+B,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;QACrE,MAAM;QACN,OAAO,CAAC,GAAG,CAAC,YAAY,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC;QACb,YAAY,CACb,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAgC;IACzE,MAAM,IAAI,GAAkB,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;IACxD,IAAI,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE;QACvC,MAAM,iBAAiB,GAAG,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI,iBAAiB,EAAE;YACrB,IAAI,GAAG,iBAAiB,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;SACxE;aAAM;YACL,IAAI,GAAG,SAAS,CAAC,eAAe,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;SAC3D;KACF;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAChE,eAAe,EACf,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAClC,CAAC;IACF,MAAM,IAAI,GAAG,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;IAE7E,4CAA4C;IAC5C,IAAI,IAAI,CAAC,eAAe,EAAE;QACxB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,GAAG,CAAC;KACZ;IAED,OAAO,GAAG,IAAI,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgC;IACjE,OAAO,gBAAgB,CAAC,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC,aAAa,IAAI,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AACpG,CAAC"}
|
||||||
+3
@@ -0,0 +1,3 @@
|
|||||||
|
import { DownloadOptions } from './types';
|
||||||
|
import { Downloader } from './Downloader';
|
||||||
|
export declare function getDownloaderForSystem(): Promise<Downloader<DownloadOptions>>;
|
||||||
+9
@@ -0,0 +1,9 @@
|
|||||||
|
export async function getDownloaderForSystem() {
|
||||||
|
// TODO: Resolve the downloader or default to GotDownloader
|
||||||
|
// Current thoughts are a dot-file traversal for something like
|
||||||
|
// ".electron.downloader" which would be a text file with the name of the
|
||||||
|
// npm module to import() and use as the downloader
|
||||||
|
const { GotDownloader } = await import('./GotDownloader');
|
||||||
|
return new GotDownloader();
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=downloader-resolver.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"downloader-resolver.js","sourceRoot":"","sources":["../../src/downloader-resolver.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,sBAAsB;IAC1C,2DAA2D;IAC3D,+DAA+D;IAC/D,yEAAyE;IACzE,mDAAmD;IACnD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC1D,OAAO,IAAI,aAAa,EAAE,CAAC;AAC7B,CAAC"}
|
||||||
+18
@@ -0,0 +1,18 @@
|
|||||||
|
import { ElectronDownloadRequestOptions, ElectronPlatformArtifactDetailsWithDefaults } from './types';
|
||||||
|
export { getHostArch } from './utils';
|
||||||
|
export { initializeProxy } from './proxy';
|
||||||
|
export * from './types';
|
||||||
|
/**
|
||||||
|
* Downloads an artifact from an Electron release and returns an absolute path
|
||||||
|
* to the downloaded file.
|
||||||
|
*
|
||||||
|
* @param artifactDetails - The information required to download the artifact
|
||||||
|
*/
|
||||||
|
export declare function downloadArtifact(_artifactDetails: ElectronPlatformArtifactDetailsWithDefaults): Promise<string>;
|
||||||
|
/**
|
||||||
|
* Downloads a specific version of Electron and returns an absolute path to a
|
||||||
|
* ZIP file.
|
||||||
|
*
|
||||||
|
* @param version - The version of Electron you want to download
|
||||||
|
*/
|
||||||
|
export declare function download(version: string, options?: ElectronDownloadRequestOptions): Promise<string>;
|
||||||
+134
@@ -0,0 +1,134 @@
|
|||||||
|
import debug from 'debug';
|
||||||
|
import * as fs from 'fs-extra';
|
||||||
|
import * as path from 'path';
|
||||||
|
import * as semver from 'semver';
|
||||||
|
import * as sumchecker from 'sumchecker';
|
||||||
|
import { getArtifactFileName, getArtifactRemoteURL, getArtifactVersion } from './artifact-utils';
|
||||||
|
import { Cache } from './Cache';
|
||||||
|
import { getDownloaderForSystem } from './downloader-resolver';
|
||||||
|
import { initializeProxy } from './proxy';
|
||||||
|
import { withTempDirectoryIn, getHostArch, getNodeArch, ensureIsTruthyString, isOfficialLinuxIA32Download, } from './utils';
|
||||||
|
export { getHostArch } from './utils';
|
||||||
|
export { initializeProxy } from './proxy';
|
||||||
|
const d = debug('@electron/get:index');
|
||||||
|
if (process.env.ELECTRON_GET_USE_PROXY) {
|
||||||
|
initializeProxy();
|
||||||
|
}
|
||||||
|
async function validateArtifact(artifactDetails, downloadedAssetPath, _downloadArtifact) {
|
||||||
|
return await withTempDirectoryIn(artifactDetails.tempDirectory, async (tempFolder) => {
|
||||||
|
// Don't try to verify the hash of the hash file itself
|
||||||
|
// and for older versions that don't have a SHASUMS256.txt
|
||||||
|
if (!artifactDetails.artifactName.startsWith('SHASUMS256') &&
|
||||||
|
!artifactDetails.unsafelyDisableChecksums &&
|
||||||
|
semver.gte(artifactDetails.version, '1.3.2')) {
|
||||||
|
let shasumPath;
|
||||||
|
const checksums = artifactDetails.checksums;
|
||||||
|
if (checksums) {
|
||||||
|
shasumPath = path.resolve(tempFolder, 'SHASUMS256.txt');
|
||||||
|
const fileNames = Object.keys(checksums);
|
||||||
|
if (fileNames.length === 0) {
|
||||||
|
throw new Error('Provided "checksums" object is empty, cannot generate a valid SHASUMS256.txt');
|
||||||
|
}
|
||||||
|
const generatedChecksums = fileNames
|
||||||
|
.map(fileName => `${checksums[fileName]} *${fileName}`)
|
||||||
|
.join('\n');
|
||||||
|
await fs.writeFile(shasumPath, generatedChecksums);
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
shasumPath = await _downloadArtifact({
|
||||||
|
isGeneric: true,
|
||||||
|
version: artifactDetails.version,
|
||||||
|
artifactName: 'SHASUMS256.txt',
|
||||||
|
force: artifactDetails.force,
|
||||||
|
downloadOptions: artifactDetails.downloadOptions,
|
||||||
|
cacheRoot: artifactDetails.cacheRoot,
|
||||||
|
downloader: artifactDetails.downloader,
|
||||||
|
mirrorOptions: artifactDetails.mirrorOptions,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
// For versions 1.3.2 - 1.3.4, need to overwrite the `defaultTextEncoding` option:
|
||||||
|
// https://github.com/electron/electron/pull/6676#discussion_r75332120
|
||||||
|
if (semver.satisfies(artifactDetails.version, '1.3.2 - 1.3.4')) {
|
||||||
|
const validatorOptions = {};
|
||||||
|
validatorOptions.defaultTextEncoding = 'binary';
|
||||||
|
const checker = new sumchecker.ChecksumValidator('sha256', shasumPath, validatorOptions);
|
||||||
|
await checker.validate(path.dirname(downloadedAssetPath), path.basename(downloadedAssetPath));
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
await sumchecker('sha256', shasumPath, path.dirname(downloadedAssetPath), [
|
||||||
|
path.basename(downloadedAssetPath),
|
||||||
|
]);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Downloads an artifact from an Electron release and returns an absolute path
|
||||||
|
* to the downloaded file.
|
||||||
|
*
|
||||||
|
* @param artifactDetails - The information required to download the artifact
|
||||||
|
*/
|
||||||
|
export async function downloadArtifact(_artifactDetails) {
|
||||||
|
const artifactDetails = Object.assign({}, _artifactDetails);
|
||||||
|
if (!_artifactDetails.isGeneric) {
|
||||||
|
const platformArtifactDetails = artifactDetails;
|
||||||
|
if (!platformArtifactDetails.platform) {
|
||||||
|
d('No platform found, defaulting to the host platform');
|
||||||
|
platformArtifactDetails.platform = process.platform;
|
||||||
|
}
|
||||||
|
if (platformArtifactDetails.arch) {
|
||||||
|
platformArtifactDetails.arch = getNodeArch(platformArtifactDetails.arch);
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
d('No arch found, defaulting to the host arch');
|
||||||
|
platformArtifactDetails.arch = getHostArch();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
ensureIsTruthyString(artifactDetails, 'version');
|
||||||
|
artifactDetails.version = getArtifactVersion(artifactDetails);
|
||||||
|
const fileName = getArtifactFileName(artifactDetails);
|
||||||
|
const url = await getArtifactRemoteURL(artifactDetails);
|
||||||
|
const cache = new Cache(artifactDetails.cacheRoot);
|
||||||
|
// Do not check if the file exists in the cache when force === true
|
||||||
|
if (!artifactDetails.force) {
|
||||||
|
d(`Checking the cache (${artifactDetails.cacheRoot}) for ${fileName} (${url})`);
|
||||||
|
const cachedPath = await cache.getPathForFileInCache(url, fileName);
|
||||||
|
if (cachedPath === null) {
|
||||||
|
d('Cache miss');
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
d('Cache hit');
|
||||||
|
try {
|
||||||
|
await validateArtifact(artifactDetails, cachedPath, downloadArtifact);
|
||||||
|
return cachedPath;
|
||||||
|
}
|
||||||
|
catch (err) {
|
||||||
|
d("Artifact in cache didn't match checksums", err);
|
||||||
|
d('falling back to re-download');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (!artifactDetails.isGeneric &&
|
||||||
|
isOfficialLinuxIA32Download(artifactDetails.platform, artifactDetails.arch, artifactDetails.version, artifactDetails.mirrorOptions)) {
|
||||||
|
console.warn('Official Linux/ia32 support is deprecated.');
|
||||||
|
console.warn('For more info: https://electronjs.org/blog/linux-32bit-support');
|
||||||
|
}
|
||||||
|
return await withTempDirectoryIn(artifactDetails.tempDirectory, async (tempFolder) => {
|
||||||
|
const tempDownloadPath = path.resolve(tempFolder, getArtifactFileName(artifactDetails));
|
||||||
|
const downloader = artifactDetails.downloader || (await getDownloaderForSystem());
|
||||||
|
d(`Downloading ${url} to ${tempDownloadPath} with options: ${JSON.stringify(artifactDetails.downloadOptions)}`);
|
||||||
|
await downloader.download(url, tempDownloadPath, artifactDetails.downloadOptions);
|
||||||
|
await validateArtifact(artifactDetails, tempDownloadPath, downloadArtifact);
|
||||||
|
return await cache.putFileInCache(url, tempDownloadPath, fileName);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Downloads a specific version of Electron and returns an absolute path to a
|
||||||
|
* ZIP file.
|
||||||
|
*
|
||||||
|
* @param version - The version of Electron you want to download
|
||||||
|
*/
|
||||||
|
export function download(version, options) {
|
||||||
|
return downloadArtifact(Object.assign(Object.assign({}, options), { version, platform: process.platform, arch: process.arch, artifactName: 'electron' }));
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=index.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
|
||||||
+4
@@ -0,0 +1,4 @@
|
|||||||
|
/**
|
||||||
|
* Initializes a third-party proxy module for HTTP(S) requests.
|
||||||
|
*/
|
||||||
|
export declare function initializeProxy(): void;
|
||||||
+24
@@ -0,0 +1,24 @@
|
|||||||
|
import * as debug from 'debug';
|
||||||
|
import { getEnv, setEnv } from './utils';
|
||||||
|
const d = debug('@electron/get:proxy');
|
||||||
|
/**
|
||||||
|
* Initializes a third-party proxy module for HTTP(S) requests.
|
||||||
|
*/
|
||||||
|
export function initializeProxy() {
|
||||||
|
try {
|
||||||
|
// See: https://github.com/electron/get/pull/214#discussion_r798845713
|
||||||
|
const env = getEnv('GLOBAL_AGENT_');
|
||||||
|
setEnv('GLOBAL_AGENT_HTTP_PROXY', env('HTTP_PROXY'));
|
||||||
|
setEnv('GLOBAL_AGENT_HTTPS_PROXY', env('HTTPS_PROXY'));
|
||||||
|
setEnv('GLOBAL_AGENT_NO_PROXY', env('NO_PROXY'));
|
||||||
|
/**
|
||||||
|
* TODO: replace global-agent with a hpagent. @BlackHole1
|
||||||
|
* https://github.com/sindresorhus/got/blob/HEAD/documentation/tips.md#proxying
|
||||||
|
*/
|
||||||
|
require('global-agent').bootstrap();
|
||||||
|
}
|
||||||
|
catch (e) {
|
||||||
|
d('Could not load either proxy modules, built-in proxy support not available:', e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=proxy.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,CAAC,GAAG,KAAK,CAAC,qBAAqB,CAAC,CAAC;AAEvC;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI;QACF,sEAAsE;QACtE,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;QAEpC,MAAM,CAAC,yBAAyB,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,0BAA0B,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,uBAAuB,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;QAEjD;;;WAGG;QACH,OAAO,CAAC,cAAc,CAAC,CAAC,SAAS,EAAE,CAAC;KACrC;IAAC,OAAO,CAAC,EAAE;QACV,CAAC,CAAC,4EAA4E,EAAE,CAAC,CAAC,CAAC;KACpF;AACH,CAAC"}
|
||||||
+129
@@ -0,0 +1,129 @@
|
|||||||
|
import { Downloader } from './Downloader';
|
||||||
|
export declare type DownloadOptions = any;
|
||||||
|
export interface MirrorOptions {
|
||||||
|
/**
|
||||||
|
* DEPRECATED - see nightlyMirror.
|
||||||
|
*/
|
||||||
|
nightly_mirror?: string;
|
||||||
|
/**
|
||||||
|
* The Electron nightly-specific mirror URL.
|
||||||
|
*/
|
||||||
|
nightlyMirror?: string;
|
||||||
|
/**
|
||||||
|
* The base URL of the mirror to download from,
|
||||||
|
* e.g https://github.com/electron/electron/releases/download
|
||||||
|
*/
|
||||||
|
mirror?: string;
|
||||||
|
/**
|
||||||
|
* The name of the directory to download from,
|
||||||
|
* often scoped by version number e.g 'v4.0.4'
|
||||||
|
*/
|
||||||
|
customDir?: string;
|
||||||
|
/**
|
||||||
|
* The name of the asset to download,
|
||||||
|
* e.g 'electron-v4.0.4-linux-x64.zip'
|
||||||
|
*/
|
||||||
|
customFilename?: string;
|
||||||
|
/**
|
||||||
|
* The version of the asset to download,
|
||||||
|
* e.g '4.0.4'
|
||||||
|
*/
|
||||||
|
customVersion?: string;
|
||||||
|
/**
|
||||||
|
* A function allowing customization of the url returned
|
||||||
|
* from getArtifactRemoteURL().
|
||||||
|
*/
|
||||||
|
resolveAssetURL?: (opts: DownloadOptions) => Promise<string>;
|
||||||
|
}
|
||||||
|
export interface ElectronDownloadRequest {
|
||||||
|
/**
|
||||||
|
* The version of Electron associated with the artifact.
|
||||||
|
*/
|
||||||
|
version: string;
|
||||||
|
/**
|
||||||
|
* The type of artifact. For example:
|
||||||
|
* * `electron`
|
||||||
|
* * `ffmpeg`
|
||||||
|
*/
|
||||||
|
artifactName: string;
|
||||||
|
}
|
||||||
|
export interface ElectronDownloadRequestOptions {
|
||||||
|
/**
|
||||||
|
* Whether to download an artifact regardless of whether it's in the cache directory.
|
||||||
|
*
|
||||||
|
* Defaults to `false`.
|
||||||
|
*/
|
||||||
|
force?: boolean;
|
||||||
|
/**
|
||||||
|
* When set to `true`, disables checking that the artifact download completed successfully
|
||||||
|
* with the correct payload.
|
||||||
|
*
|
||||||
|
* Defaults to `false`.
|
||||||
|
*/
|
||||||
|
unsafelyDisableChecksums?: boolean;
|
||||||
|
/**
|
||||||
|
* Provides checksums for the artifact as strings.
|
||||||
|
* Can be used if you already know the checksums of the Electron artifact
|
||||||
|
* you are downloading and want to skip the checksum file download
|
||||||
|
* without skipping the checksum validation.
|
||||||
|
*
|
||||||
|
* This should be an object whose keys are the file names of the artifacts and
|
||||||
|
* the values are their respective SHA256 checksums.
|
||||||
|
*/
|
||||||
|
checksums?: Record<string, string>;
|
||||||
|
/**
|
||||||
|
* The directory that caches Electron artifact downloads.
|
||||||
|
*
|
||||||
|
* The default value is dependent upon the host platform:
|
||||||
|
*
|
||||||
|
* * Linux: `$XDG_CACHE_HOME` or `~/.cache/electron/`
|
||||||
|
* * MacOS: `~/Library/Caches/electron/`
|
||||||
|
* * Windows: `%LOCALAPPDATA%/electron/Cache` or `~/AppData/Local/electron/Cache/`
|
||||||
|
*/
|
||||||
|
cacheRoot?: string;
|
||||||
|
/**
|
||||||
|
* Options passed to the downloader module.
|
||||||
|
*/
|
||||||
|
downloadOptions?: DownloadOptions;
|
||||||
|
/**
|
||||||
|
* Options related to specifying an artifact mirror.
|
||||||
|
*/
|
||||||
|
mirrorOptions?: MirrorOptions;
|
||||||
|
/**
|
||||||
|
* The custom [[Downloader]] class used to download artifacts. Defaults to the
|
||||||
|
* built-in [[GotDownloader]].
|
||||||
|
*/
|
||||||
|
downloader?: Downloader<DownloadOptions>;
|
||||||
|
/**
|
||||||
|
* A temporary directory for downloads.
|
||||||
|
* It is used before artifacts are put into cache.
|
||||||
|
*/
|
||||||
|
tempDirectory?: string;
|
||||||
|
}
|
||||||
|
export declare type ElectronPlatformArtifactDetails = {
|
||||||
|
/**
|
||||||
|
* The target artifact platform. These are Node-style platform names, for example:
|
||||||
|
* * `win32`
|
||||||
|
* * `darwin`
|
||||||
|
* * `linux`
|
||||||
|
*/
|
||||||
|
platform: string;
|
||||||
|
/**
|
||||||
|
* The target artifact architecture. These are Node-style architecture names, for example:
|
||||||
|
* * `ia32`
|
||||||
|
* * `x64`
|
||||||
|
* * `armv7l`
|
||||||
|
*/
|
||||||
|
arch: string;
|
||||||
|
artifactSuffix?: string;
|
||||||
|
isGeneric?: false;
|
||||||
|
} & ElectronDownloadRequest & ElectronDownloadRequestOptions;
|
||||||
|
export declare type ElectronGenericArtifactDetails = {
|
||||||
|
isGeneric: true;
|
||||||
|
} & ElectronDownloadRequest & ElectronDownloadRequestOptions;
|
||||||
|
export declare type ElectronArtifactDetails = ElectronPlatformArtifactDetails | ElectronGenericArtifactDetails;
|
||||||
|
export declare type Omit<T, K> = Pick<T, Exclude<keyof T, K>>;
|
||||||
|
export declare type ElectronPlatformArtifactDetailsWithDefaults = (Omit<ElectronPlatformArtifactDetails, 'platform' | 'arch'> & {
|
||||||
|
platform?: string;
|
||||||
|
arch?: string;
|
||||||
|
}) | ElectronGenericArtifactDetails;
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
//# sourceMappingURL=types.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}
|
||||||
+25
@@ -0,0 +1,25 @@
|
|||||||
|
export declare function withTempDirectoryIn<T>(parentDirectory: string | undefined, fn: (directory: string) => Promise<T>): Promise<T>;
|
||||||
|
export declare function withTempDirectory<T>(fn: (directory: string) => Promise<T>): Promise<T>;
|
||||||
|
export declare function normalizeVersion(version: string): string;
|
||||||
|
/**
|
||||||
|
* Runs the `uname` command and returns the trimmed output.
|
||||||
|
*/
|
||||||
|
export declare function uname(): string;
|
||||||
|
/**
|
||||||
|
* Generates an architecture name that would be used in an Electron or Node.js
|
||||||
|
* download file name.
|
||||||
|
*/
|
||||||
|
export declare function getNodeArch(arch: string): string;
|
||||||
|
/**
|
||||||
|
* Generates an architecture name that would be used in an Electron or Node.js
|
||||||
|
* download file name, from the `process` module information.
|
||||||
|
*/
|
||||||
|
export declare function getHostArch(): string;
|
||||||
|
export declare function ensureIsTruthyString<T, K extends keyof T>(obj: T, key: K): void;
|
||||||
|
export declare function isOfficialLinuxIA32Download(platform: string, arch: string, version: string, mirrorOptions?: object): boolean;
|
||||||
|
/**
|
||||||
|
* Find the value of a environment variable which may or may not have the
|
||||||
|
* prefix, in a case-insensitive manner.
|
||||||
|
*/
|
||||||
|
export declare function getEnv(prefix?: string): (name: string) => string | undefined;
|
||||||
|
export declare function setEnv(key: string, value: string | undefined): void;
|
||||||
+95
@@ -0,0 +1,95 @@
|
|||||||
|
import * as childProcess from 'child_process';
|
||||||
|
import * as fs from 'fs-extra';
|
||||||
|
import * as os from 'os';
|
||||||
|
import * as path from 'path';
|
||||||
|
async function useAndRemoveDirectory(directory, fn) {
|
||||||
|
let result;
|
||||||
|
try {
|
||||||
|
result = await fn(directory);
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
await fs.remove(directory);
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
export async function withTempDirectoryIn(parentDirectory = os.tmpdir(), fn) {
|
||||||
|
const tempDirectoryPrefix = 'electron-download-';
|
||||||
|
const tempDirectory = await fs.mkdtemp(path.resolve(parentDirectory, tempDirectoryPrefix));
|
||||||
|
return useAndRemoveDirectory(tempDirectory, fn);
|
||||||
|
}
|
||||||
|
export async function withTempDirectory(fn) {
|
||||||
|
return withTempDirectoryIn(undefined, fn);
|
||||||
|
}
|
||||||
|
export function normalizeVersion(version) {
|
||||||
|
if (!version.startsWith('v')) {
|
||||||
|
return `v${version}`;
|
||||||
|
}
|
||||||
|
return version;
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Runs the `uname` command and returns the trimmed output.
|
||||||
|
*/
|
||||||
|
export function uname() {
|
||||||
|
return childProcess
|
||||||
|
.execSync('uname -m')
|
||||||
|
.toString()
|
||||||
|
.trim();
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Generates an architecture name that would be used in an Electron or Node.js
|
||||||
|
* download file name.
|
||||||
|
*/
|
||||||
|
export function getNodeArch(arch) {
|
||||||
|
if (arch === 'arm') {
|
||||||
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
||||||
|
switch (process.config.variables.arm_version) {
|
||||||
|
case '6':
|
||||||
|
return uname();
|
||||||
|
case '7':
|
||||||
|
default:
|
||||||
|
return 'armv7l';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return arch;
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Generates an architecture name that would be used in an Electron or Node.js
|
||||||
|
* download file name, from the `process` module information.
|
||||||
|
*/
|
||||||
|
export function getHostArch() {
|
||||||
|
return getNodeArch(process.arch);
|
||||||
|
}
|
||||||
|
export function ensureIsTruthyString(obj, key) {
|
||||||
|
if (!obj[key] || typeof obj[key] !== 'string') {
|
||||||
|
throw new Error(`Expected property "${key}" to be provided as a string but it was not`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
export function isOfficialLinuxIA32Download(platform, arch, version, mirrorOptions) {
|
||||||
|
return (platform === 'linux' &&
|
||||||
|
arch === 'ia32' &&
|
||||||
|
Number(version.slice(1).split('.')[0]) >= 4 &&
|
||||||
|
typeof mirrorOptions === 'undefined');
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Find the value of a environment variable which may or may not have the
|
||||||
|
* prefix, in a case-insensitive manner.
|
||||||
|
*/
|
||||||
|
export function getEnv(prefix = '') {
|
||||||
|
const envsLowerCase = {};
|
||||||
|
for (const envKey in process.env) {
|
||||||
|
envsLowerCase[envKey.toLowerCase()] = process.env[envKey];
|
||||||
|
}
|
||||||
|
return (name) => {
|
||||||
|
return (envsLowerCase[`${prefix}${name}`.toLowerCase()] ||
|
||||||
|
envsLowerCase[name.toLowerCase()] ||
|
||||||
|
undefined);
|
||||||
|
};
|
||||||
|
}
|
||||||
|
export function setEnv(key, value) {
|
||||||
|
// The `void` operator always returns `undefined`.
|
||||||
|
// See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/void
|
||||||
|
if (value !== void 0) {
|
||||||
|
process.env[key] = value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
//# sourceMappingURL=utils.js.map
|
||||||
+1
@@ -0,0 +1 @@
|
|||||||
|
{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"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"}
|
||||||
+100
@@ -0,0 +1,100 @@
|
|||||||
|
{
|
||||||
|
"name": "@electron/get",
|
||||||
|
"version": "2.0.3",
|
||||||
|
"description": "Utility for downloading artifacts from different versions of Electron",
|
||||||
|
"main": "dist/cjs/index.js",
|
||||||
|
"module": "dist/esm/index.js",
|
||||||
|
"repository": "https://github.com/electron/get",
|
||||||
|
"author": "Samuel Attard",
|
||||||
|
"license": "MIT",
|
||||||
|
"scripts": {
|
||||||
|
"build": "tsc && tsc -p tsconfig.esm.json",
|
||||||
|
"build:docs": "typedoc --out docs",
|
||||||
|
"eslint": "eslint --ext .ts src test",
|
||||||
|
"jest": "jest --coverage",
|
||||||
|
"lint": "npm run prettier && npm run eslint",
|
||||||
|
"prettier": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
|
||||||
|
"prepublishOnly": "npm run build",
|
||||||
|
"test": "npm run lint && npm run jest",
|
||||||
|
"test:nonetwork": "npm run lint && npm run jest -- --testPathIgnorePatterns network.spec"
|
||||||
|
},
|
||||||
|
"files": [
|
||||||
|
"dist/*",
|
||||||
|
"README.md"
|
||||||
|
],
|
||||||
|
"engines": {
|
||||||
|
"node": ">=12"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"debug": "^4.1.1",
|
||||||
|
"env-paths": "^2.2.0",
|
||||||
|
"fs-extra": "^8.1.0",
|
||||||
|
"got": "^11.8.5",
|
||||||
|
"progress": "^2.0.3",
|
||||||
|
"semver": "^6.2.0",
|
||||||
|
"sumchecker": "^3.0.1"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@continuous-auth/semantic-release-npm": "^3.0.0",
|
||||||
|
"@types/debug": "^4.1.4",
|
||||||
|
"@types/fs-extra": "^8.0.0",
|
||||||
|
"@types/jest": "^24.0.13",
|
||||||
|
"@types/node": "^12.20.55",
|
||||||
|
"@types/progress": "^2.0.3",
|
||||||
|
"@types/semver": "^6.2.0",
|
||||||
|
"@typescript-eslint/eslint-plugin": "^2.34.0",
|
||||||
|
"@typescript-eslint/parser": "^2.34.0",
|
||||||
|
"eslint": "^6.8.0",
|
||||||
|
"eslint-config-prettier": "^6.15.0",
|
||||||
|
"eslint-plugin-import": "^2.22.1",
|
||||||
|
"eslint-plugin-jest": "< 24.0.0",
|
||||||
|
"husky": "^2.3.0",
|
||||||
|
"jest": "^24.8.0",
|
||||||
|
"lint-staged": "^8.1.7",
|
||||||
|
"prettier": "^1.17.1",
|
||||||
|
"ts-jest": "^24.0.0",
|
||||||
|
"typedoc": "^0.17.2",
|
||||||
|
"typescript": "^3.8.0"
|
||||||
|
},
|
||||||
|
"eslintConfig": {
|
||||||
|
"parser": "@typescript-eslint/parser",
|
||||||
|
"extends": [
|
||||||
|
"eslint:recommended",
|
||||||
|
"plugin:@typescript-eslint/eslint-recommended",
|
||||||
|
"plugin:@typescript-eslint/recommended",
|
||||||
|
"plugin:jest/recommended",
|
||||||
|
"plugin:import/errors",
|
||||||
|
"plugin:import/warnings",
|
||||||
|
"plugin:import/typescript",
|
||||||
|
"prettier",
|
||||||
|
"prettier/@typescript-eslint"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"husky": {
|
||||||
|
"hooks": {
|
||||||
|
"pre-commit": "lint-staged"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"lint-staged": {
|
||||||
|
"*.ts": [
|
||||||
|
"eslint --fix",
|
||||||
|
"prettier --write",
|
||||||
|
"git add"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"keywords": [
|
||||||
|
"electron",
|
||||||
|
"download",
|
||||||
|
"prebuild",
|
||||||
|
"get",
|
||||||
|
"artifact",
|
||||||
|
"release"
|
||||||
|
],
|
||||||
|
"optionalDependencies": {
|
||||||
|
"global-agent": "^3.0.0"
|
||||||
|
},
|
||||||
|
"resolutions": {
|
||||||
|
"eslint/inquirer": "< 7.3.0",
|
||||||
|
"**/@typescript-eslint/typescript-estree/semver": "^6.3.0"
|
||||||
|
}
|
||||||
|
}
|
||||||
+232
@@ -0,0 +1,232 @@
|
|||||||
|
/// <reference types="node" />
|
||||||
|
/// <reference lib="es2018" />
|
||||||
|
/// <reference lib="dom" />
|
||||||
|
import { Class, Falsy, TypedArray, ObservableLike, Primitive } from './types';
|
||||||
|
declare const objectTypeNames: readonly ["Function", "Generator", "AsyncGenerator", "GeneratorFunction", "AsyncGeneratorFunction", "AsyncFunction", "Observable", "Array", "Buffer", "Blob", "Object", "RegExp", "Date", "Error", "Map", "Set", "WeakMap", "WeakSet", "ArrayBuffer", "SharedArrayBuffer", "DataView", "Promise", "URL", "FormData", "URLSearchParams", "HTMLElement", ...("Int8Array" | "Uint8Array" | "Uint8ClampedArray" | "Int16Array" | "Uint16Array" | "Int32Array" | "Uint32Array" | "Float32Array" | "Float64Array" | "BigInt64Array" | "BigUint64Array")[]];
|
||||||
|
declare type ObjectTypeName = typeof objectTypeNames[number];
|
||||||
|
declare const primitiveTypeNames: readonly ["null", "undefined", "string", "number", "bigint", "boolean", "symbol"];
|
||||||
|
declare type PrimitiveTypeName = typeof primitiveTypeNames[number];
|
||||||
|
export declare type TypeName = ObjectTypeName | PrimitiveTypeName;
|
||||||
|
declare function is(value: unknown): TypeName;
|
||||||
|
declare namespace is {
|
||||||
|
var undefined: (value: unknown) => value is undefined;
|
||||||
|
var string: (value: unknown) => value is string;
|
||||||
|
var number: (value: unknown) => value is number;
|
||||||
|
var bigint: (value: unknown) => value is bigint;
|
||||||
|
var function_: (value: unknown) => value is Function;
|
||||||
|
var null_: (value: unknown) => value is null;
|
||||||
|
var class_: (value: unknown) => value is Class<unknown, any[]>;
|
||||||
|
var boolean: (value: unknown) => value is boolean;
|
||||||
|
var symbol: (value: unknown) => value is symbol;
|
||||||
|
var numericString: (value: unknown) => value is string;
|
||||||
|
var array: <T = unknown>(value: unknown, assertion?: ((value: T) => value is T) | undefined) => value is T[];
|
||||||
|
var buffer: (value: unknown) => value is Buffer;
|
||||||
|
var blob: (value: unknown) => value is Blob;
|
||||||
|
var nullOrUndefined: (value: unknown) => value is null | undefined;
|
||||||
|
var object: (value: unknown) => value is object;
|
||||||
|
var iterable: <T = unknown>(value: unknown) => value is Iterable<T>;
|
||||||
|
var asyncIterable: <T = unknown>(value: unknown) => value is AsyncIterable<T>;
|
||||||
|
var generator: (value: unknown) => value is Generator<unknown, any, unknown>;
|
||||||
|
var asyncGenerator: (value: unknown) => value is AsyncGenerator<unknown, any, unknown>;
|
||||||
|
var nativePromise: <T = unknown>(value: unknown) => value is Promise<T>;
|
||||||
|
var promise: <T = unknown>(value: unknown) => value is Promise<T>;
|
||||||
|
var generatorFunction: (value: unknown) => value is GeneratorFunction;
|
||||||
|
var asyncGeneratorFunction: (value: unknown) => value is (...args: any[]) => Promise<unknown>;
|
||||||
|
var asyncFunction: <T = unknown>(value: unknown) => value is (...args: any[]) => Promise<T>;
|
||||||
|
var boundFunction: (value: unknown) => value is Function;
|
||||||
|
var regExp: (value: unknown) => value is RegExp;
|
||||||
|
var date: (value: unknown) => value is Date;
|
||||||
|
var error: (value: unknown) => value is Error;
|
||||||
|
var map: <Key = unknown, Value = unknown>(value: unknown) => value is Map<Key, Value>;
|
||||||
|
var set: <T = unknown>(value: unknown) => value is Set<T>;
|
||||||
|
var weakMap: <Key extends object = object, Value = unknown>(value: unknown) => value is WeakMap<Key, Value>;
|
||||||
|
var weakSet: (value: unknown) => value is WeakSet<object>;
|
||||||
|
var int8Array: (value: unknown) => value is Int8Array;
|
||||||
|
var uint8Array: (value: unknown) => value is Uint8Array;
|
||||||
|
var uint8ClampedArray: (value: unknown) => value is Uint8ClampedArray;
|
||||||
|
var int16Array: (value: unknown) => value is Int16Array;
|
||||||
|
var uint16Array: (value: unknown) => value is Uint16Array;
|
||||||
|
var int32Array: (value: unknown) => value is Int32Array;
|
||||||
|
var uint32Array: (value: unknown) => value is Uint32Array;
|
||||||
|
var float32Array: (value: unknown) => value is Float32Array;
|
||||||
|
var float64Array: (value: unknown) => value is Float64Array;
|
||||||
|
var bigInt64Array: (value: unknown) => value is BigInt64Array;
|
||||||
|
var bigUint64Array: (value: unknown) => value is BigUint64Array;
|
||||||
|
var arrayBuffer: (value: unknown) => value is ArrayBuffer;
|
||||||
|
var sharedArrayBuffer: (value: unknown) => value is SharedArrayBuffer;
|
||||||
|
var dataView: (value: unknown) => value is DataView;
|
||||||
|
var enumCase: <T = unknown>(value: unknown, targetEnum: T) => boolean;
|
||||||
|
var directInstanceOf: <T>(instance: unknown, class_: Class<T, any[]>) => instance is T;
|
||||||
|
var urlInstance: (value: unknown) => value is URL;
|
||||||
|
var urlString: (value: unknown) => value is string;
|
||||||
|
var truthy: <T>(value: false | "" | 0 | 0n | T | null | undefined) => value is T;
|
||||||
|
var falsy: <T>(value: false | "" | 0 | 0n | T | null | undefined) => value is Falsy;
|
||||||
|
var nan: (value: unknown) => boolean;
|
||||||
|
var primitive: (value: unknown) => value is Primitive;
|
||||||
|
var integer: (value: unknown) => value is number;
|
||||||
|
var safeInteger: (value: unknown) => value is number;
|
||||||
|
var plainObject: <Value = unknown>(value: unknown) => value is Record<string | number | symbol, Value>;
|
||||||
|
var typedArray: (value: unknown) => value is TypedArray;
|
||||||
|
var arrayLike: <T = unknown>(value: unknown) => value is ArrayLike<T>;
|
||||||
|
var inRange: (value: number, range: number | number[]) => value is number;
|
||||||
|
var domElement: (value: unknown) => value is HTMLElement;
|
||||||
|
var observable: (value: unknown) => value is ObservableLike;
|
||||||
|
var nodeStream: (value: unknown) => value is NodeStream;
|
||||||
|
var infinite: (value: unknown) => value is number;
|
||||||
|
var evenInteger: (value: number) => value is number;
|
||||||
|
var oddInteger: (value: number) => value is number;
|
||||||
|
var emptyArray: (value: unknown) => value is never[];
|
||||||
|
var nonEmptyArray: (value: unknown) => value is unknown[];
|
||||||
|
var emptyString: (value: unknown) => value is "";
|
||||||
|
var emptyStringOrWhitespace: (value: unknown) => value is string;
|
||||||
|
var nonEmptyString: (value: unknown) => value is string;
|
||||||
|
var nonEmptyStringAndNotWhitespace: (value: unknown) => value is string;
|
||||||
|
var emptyObject: <Key extends string | number | symbol = string>(value: unknown) => value is Record<Key, never>;
|
||||||
|
var nonEmptyObject: <Key extends string | number | symbol = string, Value = unknown>(value: unknown) => value is Record<Key, Value>;
|
||||||
|
var emptySet: (value: unknown) => value is Set<never>;
|
||||||
|
var nonEmptySet: <T = unknown>(value: unknown) => value is Set<T>;
|
||||||
|
var emptyMap: (value: unknown) => value is Map<never, never>;
|
||||||
|
var nonEmptyMap: <Key = unknown, Value = unknown>(value: unknown) => value is Map<Key, Value>;
|
||||||
|
var propertyKey: (value: unknown) => value is string | number | symbol;
|
||||||
|
var formData: (value: unknown) => value is FormData;
|
||||||
|
var urlSearchParams: (value: unknown) => value is URLSearchParams;
|
||||||
|
var any: (predicate: Predicate | Predicate[], ...values: unknown[]) => boolean;
|
||||||
|
var all: (predicate: Predicate, ...values: unknown[]) => boolean;
|
||||||
|
}
|
||||||
|
export interface ArrayLike<T> {
|
||||||
|
readonly [index: number]: T;
|
||||||
|
readonly length: number;
|
||||||
|
}
|
||||||
|
export interface NodeStream extends NodeJS.EventEmitter {
|
||||||
|
pipe<T extends NodeJS.WritableStream>(destination: T, options?: {
|
||||||
|
end?: boolean;
|
||||||
|
}): T;
|
||||||
|
}
|
||||||
|
export declare type Predicate = (value: unknown) => boolean;
|
||||||
|
export declare const enum AssertionTypeDescription {
|
||||||
|
class_ = "Class",
|
||||||
|
numericString = "string with a number",
|
||||||
|
nullOrUndefined = "null or undefined",
|
||||||
|
iterable = "Iterable",
|
||||||
|
asyncIterable = "AsyncIterable",
|
||||||
|
nativePromise = "native Promise",
|
||||||
|
urlString = "string with a URL",
|
||||||
|
truthy = "truthy",
|
||||||
|
falsy = "falsy",
|
||||||
|
nan = "NaN",
|
||||||
|
primitive = "primitive",
|
||||||
|
integer = "integer",
|
||||||
|
safeInteger = "integer",
|
||||||
|
plainObject = "plain object",
|
||||||
|
arrayLike = "array-like",
|
||||||
|
typedArray = "TypedArray",
|
||||||
|
domElement = "HTMLElement",
|
||||||
|
nodeStream = "Node.js Stream",
|
||||||
|
infinite = "infinite number",
|
||||||
|
emptyArray = "empty array",
|
||||||
|
nonEmptyArray = "non-empty array",
|
||||||
|
emptyString = "empty string",
|
||||||
|
emptyStringOrWhitespace = "empty string or whitespace",
|
||||||
|
nonEmptyString = "non-empty string",
|
||||||
|
nonEmptyStringAndNotWhitespace = "non-empty string and not whitespace",
|
||||||
|
emptyObject = "empty object",
|
||||||
|
nonEmptyObject = "non-empty object",
|
||||||
|
emptySet = "empty set",
|
||||||
|
nonEmptySet = "non-empty set",
|
||||||
|
emptyMap = "empty map",
|
||||||
|
nonEmptyMap = "non-empty map",
|
||||||
|
evenInteger = "even integer",
|
||||||
|
oddInteger = "odd integer",
|
||||||
|
directInstanceOf = "T",
|
||||||
|
inRange = "in range",
|
||||||
|
any = "predicate returns truthy for any value",
|
||||||
|
all = "predicate returns truthy for all values"
|
||||||
|
}
|
||||||
|
interface Assert {
|
||||||
|
undefined: (value: unknown) => asserts value is undefined;
|
||||||
|
string: (value: unknown) => asserts value is string;
|
||||||
|
number: (value: unknown) => asserts value is number;
|
||||||
|
bigint: (value: unknown) => asserts value is bigint;
|
||||||
|
function_: (value: unknown) => asserts value is Function;
|
||||||
|
null_: (value: unknown) => asserts value is null;
|
||||||
|
class_: (value: unknown) => asserts value is Class;
|
||||||
|
boolean: (value: unknown) => asserts value is boolean;
|
||||||
|
symbol: (value: unknown) => asserts value is symbol;
|
||||||
|
numericString: (value: unknown) => asserts value is string;
|
||||||
|
array: <T = unknown>(value: unknown, assertion?: (element: unknown) => asserts element is T) => asserts value is T[];
|
||||||
|
buffer: (value: unknown) => asserts value is Buffer;
|
||||||
|
blob: (value: unknown) => asserts value is Blob;
|
||||||
|
nullOrUndefined: (value: unknown) => asserts value is null | undefined;
|
||||||
|
object: <Key extends keyof any = string, Value = unknown>(value: unknown) => asserts value is Record<Key, Value>;
|
||||||
|
iterable: <T = unknown>(value: unknown) => asserts value is Iterable<T>;
|
||||||
|
asyncIterable: <T = unknown>(value: unknown) => asserts value is AsyncIterable<T>;
|
||||||
|
generator: (value: unknown) => asserts value is Generator;
|
||||||
|
asyncGenerator: (value: unknown) => asserts value is AsyncGenerator;
|
||||||
|
nativePromise: <T = unknown>(value: unknown) => asserts value is Promise<T>;
|
||||||
|
promise: <T = unknown>(value: unknown) => asserts value is Promise<T>;
|
||||||
|
generatorFunction: (value: unknown) => asserts value is GeneratorFunction;
|
||||||
|
asyncGeneratorFunction: (value: unknown) => asserts value is AsyncGeneratorFunction;
|
||||||
|
asyncFunction: (value: unknown) => asserts value is Function;
|
||||||
|
boundFunction: (value: unknown) => asserts value is Function;
|
||||||
|
regExp: (value: unknown) => asserts value is RegExp;
|
||||||
|
date: (value: unknown) => asserts value is Date;
|
||||||
|
error: (value: unknown) => asserts value is Error;
|
||||||
|
map: <Key = unknown, Value = unknown>(value: unknown) => asserts value is Map<Key, Value>;
|
||||||
|
set: <T = unknown>(value: unknown) => asserts value is Set<T>;
|
||||||
|
weakMap: <Key extends object = object, Value = unknown>(value: unknown) => asserts value is WeakMap<Key, Value>;
|
||||||
|
weakSet: <T extends object = object>(value: unknown) => asserts value is WeakSet<T>;
|
||||||
|
int8Array: (value: unknown) => asserts value is Int8Array;
|
||||||
|
uint8Array: (value: unknown) => asserts value is Uint8Array;
|
||||||
|
uint8ClampedArray: (value: unknown) => asserts value is Uint8ClampedArray;
|
||||||
|
int16Array: (value: unknown) => asserts value is Int16Array;
|
||||||
|
uint16Array: (value: unknown) => asserts value is Uint16Array;
|
||||||
|
int32Array: (value: unknown) => asserts value is Int32Array;
|
||||||
|
uint32Array: (value: unknown) => asserts value is Uint32Array;
|
||||||
|
float32Array: (value: unknown) => asserts value is Float32Array;
|
||||||
|
float64Array: (value: unknown) => asserts value is Float64Array;
|
||||||
|
bigInt64Array: (value: unknown) => asserts value is BigInt64Array;
|
||||||
|
bigUint64Array: (value: unknown) => asserts value is BigUint64Array;
|
||||||
|
arrayBuffer: (value: unknown) => asserts value is ArrayBuffer;
|
||||||
|
sharedArrayBuffer: (value: unknown) => asserts value is SharedArrayBuffer;
|
||||||
|
dataView: (value: unknown) => asserts value is DataView;
|
||||||
|
enumCase: <T = unknown>(value: unknown, targetEnum: T) => asserts value is T[keyof T];
|
||||||
|
urlInstance: (value: unknown) => asserts value is URL;
|
||||||
|
urlString: (value: unknown) => asserts value is string;
|
||||||
|
truthy: (value: unknown) => asserts value is unknown;
|
||||||
|
falsy: (value: unknown) => asserts value is unknown;
|
||||||
|
nan: (value: unknown) => asserts value is unknown;
|
||||||
|
primitive: (value: unknown) => asserts value is Primitive;
|
||||||
|
integer: (value: unknown) => asserts value is number;
|
||||||
|
safeInteger: (value: unknown) => asserts value is number;
|
||||||
|
plainObject: <Value = unknown>(value: unknown) => asserts value is Record<PropertyKey, Value>;
|
||||||
|
typedArray: (value: unknown) => asserts value is TypedArray;
|
||||||
|
arrayLike: <T = unknown>(value: unknown) => asserts value is ArrayLike<T>;
|
||||||
|
domElement: (value: unknown) => asserts value is HTMLElement;
|
||||||
|
observable: (value: unknown) => asserts value is ObservableLike;
|
||||||
|
nodeStream: (value: unknown) => asserts value is NodeStream;
|
||||||
|
infinite: (value: unknown) => asserts value is number;
|
||||||
|
emptyArray: (value: unknown) => asserts value is never[];
|
||||||
|
nonEmptyArray: (value: unknown) => asserts value is unknown[];
|
||||||
|
emptyString: (value: unknown) => asserts value is '';
|
||||||
|
emptyStringOrWhitespace: (value: unknown) => asserts value is string;
|
||||||
|
nonEmptyString: (value: unknown) => asserts value is string;
|
||||||
|
nonEmptyStringAndNotWhitespace: (value: unknown) => asserts value is string;
|
||||||
|
emptyObject: <Key extends keyof any = string>(value: unknown) => asserts value is Record<Key, never>;
|
||||||
|
nonEmptyObject: <Key extends keyof any = string, Value = unknown>(value: unknown) => asserts value is Record<Key, Value>;
|
||||||
|
emptySet: (value: unknown) => asserts value is Set<never>;
|
||||||
|
nonEmptySet: <T = unknown>(value: unknown) => asserts value is Set<T>;
|
||||||
|
emptyMap: (value: unknown) => asserts value is Map<never, never>;
|
||||||
|
nonEmptyMap: <Key = unknown, Value = unknown>(value: unknown) => asserts value is Map<Key, Value>;
|
||||||
|
propertyKey: (value: unknown) => asserts value is PropertyKey;
|
||||||
|
formData: (value: unknown) => asserts value is FormData;
|
||||||
|
urlSearchParams: (value: unknown) => asserts value is URLSearchParams;
|
||||||
|
evenInteger: (value: number) => asserts value is number;
|
||||||
|
oddInteger: (value: number) => asserts value is number;
|
||||||
|
directInstanceOf: <T>(instance: unknown, class_: Class<T>) => asserts instance is T;
|
||||||
|
inRange: (value: number, range: number | number[]) => asserts value is number;
|
||||||
|
any: (predicate: Predicate | Predicate[], ...values: unknown[]) => void | never;
|
||||||
|
all: (predicate: Predicate, ...values: unknown[]) => void | never;
|
||||||
|
}
|
||||||
|
export declare const assert: Assert;
|
||||||
|
export default is;
|
||||||
|
export { Class, TypedArray, ObservableLike, Primitive } from './types';
|
||||||
+434
@@ -0,0 +1,434 @@
|
|||||||
|
"use strict";
|
||||||
|
/// <reference lib="es2018"/>
|
||||||
|
/// <reference lib="dom"/>
|
||||||
|
/// <reference types="node"/>
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const typedArrayTypeNames = [
|
||||||
|
'Int8Array',
|
||||||
|
'Uint8Array',
|
||||||
|
'Uint8ClampedArray',
|
||||||
|
'Int16Array',
|
||||||
|
'Uint16Array',
|
||||||
|
'Int32Array',
|
||||||
|
'Uint32Array',
|
||||||
|
'Float32Array',
|
||||||
|
'Float64Array',
|
||||||
|
'BigInt64Array',
|
||||||
|
'BigUint64Array'
|
||||||
|
];
|
||||||
|
function isTypedArrayName(name) {
|
||||||
|
return typedArrayTypeNames.includes(name);
|
||||||
|
}
|
||||||
|
const objectTypeNames = [
|
||||||
|
'Function',
|
||||||
|
'Generator',
|
||||||
|
'AsyncGenerator',
|
||||||
|
'GeneratorFunction',
|
||||||
|
'AsyncGeneratorFunction',
|
||||||
|
'AsyncFunction',
|
||||||
|
'Observable',
|
||||||
|
'Array',
|
||||||
|
'Buffer',
|
||||||
|
'Blob',
|
||||||
|
'Object',
|
||||||
|
'RegExp',
|
||||||
|
'Date',
|
||||||
|
'Error',
|
||||||
|
'Map',
|
||||||
|
'Set',
|
||||||
|
'WeakMap',
|
||||||
|
'WeakSet',
|
||||||
|
'ArrayBuffer',
|
||||||
|
'SharedArrayBuffer',
|
||||||
|
'DataView',
|
||||||
|
'Promise',
|
||||||
|
'URL',
|
||||||
|
'FormData',
|
||||||
|
'URLSearchParams',
|
||||||
|
'HTMLElement',
|
||||||
|
...typedArrayTypeNames
|
||||||
|
];
|
||||||
|
function isObjectTypeName(name) {
|
||||||
|
return objectTypeNames.includes(name);
|
||||||
|
}
|
||||||
|
const primitiveTypeNames = [
|
||||||
|
'null',
|
||||||
|
'undefined',
|
||||||
|
'string',
|
||||||
|
'number',
|
||||||
|
'bigint',
|
||||||
|
'boolean',
|
||||||
|
'symbol'
|
||||||
|
];
|
||||||
|
function isPrimitiveTypeName(name) {
|
||||||
|
return primitiveTypeNames.includes(name);
|
||||||
|
}
|
||||||
|
// eslint-disable-next-line @typescript-eslint/ban-types
|
||||||
|
function isOfType(type) {
|
||||||
|
return (value) => typeof value === type;
|
||||||
|
}
|
||||||
|
const { toString } = Object.prototype;
|
||||||
|
const getObjectType = (value) => {
|
||||||
|
const objectTypeName = toString.call(value).slice(8, -1);
|
||||||
|
if (/HTML\w+Element/.test(objectTypeName) && is.domElement(value)) {
|
||||||
|
return 'HTMLElement';
|
||||||
|
}
|
||||||
|
if (isObjectTypeName(objectTypeName)) {
|
||||||
|
return objectTypeName;
|
||||||
|
}
|
||||||
|
return undefined;
|
||||||
|
};
|
||||||
|
const isObjectOfType = (type) => (value) => getObjectType(value) === type;
|
||||||
|
function is(value) {
|
||||||
|
if (value === null) {
|
||||||
|
return 'null';
|
||||||
|
}
|
||||||
|
switch (typeof value) {
|
||||||
|
case 'undefined':
|
||||||
|
return 'undefined';
|
||||||
|
case 'string':
|
||||||
|
return 'string';
|
||||||
|
case 'number':
|
||||||
|
return 'number';
|
||||||
|
case 'boolean':
|
||||||
|
return 'boolean';
|
||||||
|
case 'function':
|
||||||
|
return 'Function';
|
||||||
|
case 'bigint':
|
||||||
|
return 'bigint';
|
||||||
|
case 'symbol':
|
||||||
|
return 'symbol';
|
||||||
|
default:
|
||||||
|
}
|
||||||
|
if (is.observable(value)) {
|
||||||
|
return 'Observable';
|
||||||
|
}
|
||||||
|
if (is.array(value)) {
|
||||||
|
return 'Array';
|
||||||
|
}
|
||||||
|
if (is.buffer(value)) {
|
||||||
|
return 'Buffer';
|
||||||
|
}
|
||||||
|
const tagType = getObjectType(value);
|
||||||
|
if (tagType) {
|
||||||
|
return tagType;
|
||||||
|
}
|
||||||
|
if (value instanceof String || value instanceof Boolean || value instanceof Number) {
|
||||||
|
throw new TypeError('Please don\'t use object wrappers for primitive types');
|
||||||
|
}
|
||||||
|
return 'Object';
|
||||||
|
}
|
||||||
|
is.undefined = isOfType('undefined');
|
||||||
|
is.string = isOfType('string');
|
||||||
|
const isNumberType = isOfType('number');
|
||||||
|
is.number = (value) => isNumberType(value) && !is.nan(value);
|
||||||
|
is.bigint = isOfType('bigint');
|
||||||
|
// eslint-disable-next-line @typescript-eslint/ban-types
|
||||||
|
is.function_ = isOfType('function');
|
||||||
|
is.null_ = (value) => value === null;
|
||||||
|
is.class_ = (value) => is.function_(value) && value.toString().startsWith('class ');
|
||||||
|
is.boolean = (value) => value === true || value === false;
|
||||||
|
is.symbol = isOfType('symbol');
|
||||||
|
is.numericString = (value) => is.string(value) && !is.emptyStringOrWhitespace(value) && !Number.isNaN(Number(value));
|
||||||
|
is.array = (value, assertion) => {
|
||||||
|
if (!Array.isArray(value)) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
if (!is.function_(assertion)) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return value.every(assertion);
|
||||||
|
};
|
||||||
|
is.buffer = (value) => { var _a, _b, _c, _d; return (_d = (_c = (_b = (_a = value) === null || _a === void 0 ? void 0 : _a.constructor) === null || _b === void 0 ? void 0 : _b.isBuffer) === null || _c === void 0 ? void 0 : _c.call(_b, value)) !== null && _d !== void 0 ? _d : false; };
|
||||||
|
is.blob = (value) => isObjectOfType('Blob')(value);
|
||||||
|
is.nullOrUndefined = (value) => is.null_(value) || is.undefined(value);
|
||||||
|
is.object = (value) => !is.null_(value) && (typeof value === 'object' || is.function_(value));
|
||||||
|
is.iterable = (value) => { var _a; return is.function_((_a = value) === null || _a === void 0 ? void 0 : _a[Symbol.iterator]); };
|
||||||
|
is.asyncIterable = (value) => { var _a; return is.function_((_a = value) === null || _a === void 0 ? void 0 : _a[Symbol.asyncIterator]); };
|
||||||
|
is.generator = (value) => { var _a, _b; return is.iterable(value) && is.function_((_a = value) === null || _a === void 0 ? void 0 : _a.next) && is.function_((_b = value) === null || _b === void 0 ? void 0 : _b.throw); };
|
||||||
|
is.asyncGenerator = (value) => is.asyncIterable(value) && is.function_(value.next) && is.function_(value.throw);
|
||||||
|
is.nativePromise = (value) => isObjectOfType('Promise')(value);
|
||||||
|
const hasPromiseAPI = (value) => {
|
||||||
|
var _a, _b;
|
||||||
|
return is.function_((_a = value) === null || _a === void 0 ? void 0 : _a.then) &&
|
||||||
|
is.function_((_b = value) === null || _b === void 0 ? void 0 : _b.catch);
|
||||||
|
};
|
||||||
|
is.promise = (value) => is.nativePromise(value) || hasPromiseAPI(value);
|
||||||
|
is.generatorFunction = isObjectOfType('GeneratorFunction');
|
||||||
|
is.asyncGeneratorFunction = (value) => getObjectType(value) === 'AsyncGeneratorFunction';
|
||||||
|
is.asyncFunction = (value) => getObjectType(value) === 'AsyncFunction';
|
||||||
|
// eslint-disable-next-line no-prototype-builtins, @typescript-eslint/ban-types
|
||||||
|
is.boundFunction = (value) => is.function_(value) && !value.hasOwnProperty('prototype');
|
||||||
|
is.regExp = isObjectOfType('RegExp');
|
||||||
|
is.date = isObjectOfType('Date');
|
||||||
|
is.error = isObjectOfType('Error');
|
||||||
|
is.map = (value) => isObjectOfType('Map')(value);
|
||||||
|
is.set = (value) => isObjectOfType('Set')(value);
|
||||||
|
is.weakMap = (value) => isObjectOfType('WeakMap')(value);
|
||||||
|
is.weakSet = (value) => isObjectOfType('WeakSet')(value);
|
||||||
|
is.int8Array = isObjectOfType('Int8Array');
|
||||||
|
is.uint8Array = isObjectOfType('Uint8Array');
|
||||||
|
is.uint8ClampedArray = isObjectOfType('Uint8ClampedArray');
|
||||||
|
is.int16Array = isObjectOfType('Int16Array');
|
||||||
|
is.uint16Array = isObjectOfType('Uint16Array');
|
||||||
|
is.int32Array = isObjectOfType('Int32Array');
|
||||||
|
is.uint32Array = isObjectOfType('Uint32Array');
|
||||||
|
is.float32Array = isObjectOfType('Float32Array');
|
||||||
|
is.float64Array = isObjectOfType('Float64Array');
|
||||||
|
is.bigInt64Array = isObjectOfType('BigInt64Array');
|
||||||
|
is.bigUint64Array = isObjectOfType('BigUint64Array');
|
||||||
|
is.arrayBuffer = isObjectOfType('ArrayBuffer');
|
||||||
|
is.sharedArrayBuffer = isObjectOfType('SharedArrayBuffer');
|
||||||
|
is.dataView = isObjectOfType('DataView');
|
||||||
|
is.enumCase = (value, targetEnum) => Object.values(targetEnum).includes(value);
|
||||||
|
is.directInstanceOf = (instance, class_) => Object.getPrototypeOf(instance) === class_.prototype;
|
||||||
|
is.urlInstance = (value) => isObjectOfType('URL')(value);
|
||||||
|
is.urlString = (value) => {
|
||||||
|
if (!is.string(value)) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
new URL(value); // eslint-disable-line no-new
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
catch (_a) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
// Example: `is.truthy = (value: unknown): value is (not false | not 0 | not '' | not undefined | not null) => Boolean(value);`
|
||||||
|
is.truthy = (value) => Boolean(value);
|
||||||
|
// Example: `is.falsy = (value: unknown): value is (not true | 0 | '' | undefined | null) => Boolean(value);`
|
||||||
|
is.falsy = (value) => !value;
|
||||||
|
is.nan = (value) => Number.isNaN(value);
|
||||||
|
is.primitive = (value) => is.null_(value) || isPrimitiveTypeName(typeof value);
|
||||||
|
is.integer = (value) => Number.isInteger(value);
|
||||||
|
is.safeInteger = (value) => Number.isSafeInteger(value);
|
||||||
|
is.plainObject = (value) => {
|
||||||
|
// From: https://github.com/sindresorhus/is-plain-obj/blob/main/index.js
|
||||||
|
if (toString.call(value) !== '[object Object]') {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
const prototype = Object.getPrototypeOf(value);
|
||||||
|
return prototype === null || prototype === Object.getPrototypeOf({});
|
||||||
|
};
|
||||||
|
is.typedArray = (value) => isTypedArrayName(getObjectType(value));
|
||||||
|
const isValidLength = (value) => is.safeInteger(value) && value >= 0;
|
||||||
|
is.arrayLike = (value) => !is.nullOrUndefined(value) && !is.function_(value) && isValidLength(value.length);
|
||||||
|
is.inRange = (value, range) => {
|
||||||
|
if (is.number(range)) {
|
||||||
|
return value >= Math.min(0, range) && value <= Math.max(range, 0);
|
||||||
|
}
|
||||||
|
if (is.array(range) && range.length === 2) {
|
||||||
|
return value >= Math.min(...range) && value <= Math.max(...range);
|
||||||
|
}
|
||||||
|
throw new TypeError(`Invalid range: ${JSON.stringify(range)}`);
|
||||||
|
};
|
||||||
|
const NODE_TYPE_ELEMENT = 1;
|
||||||
|
const DOM_PROPERTIES_TO_CHECK = [
|
||||||
|
'innerHTML',
|
||||||
|
'ownerDocument',
|
||||||
|
'style',
|
||||||
|
'attributes',
|
||||||
|
'nodeValue'
|
||||||
|
];
|
||||||
|
is.domElement = (value) => {
|
||||||
|
return is.object(value) &&
|
||||||
|
value.nodeType === NODE_TYPE_ELEMENT &&
|
||||||
|
is.string(value.nodeName) &&
|
||||||
|
!is.plainObject(value) &&
|
||||||
|
DOM_PROPERTIES_TO_CHECK.every(property => property in value);
|
||||||
|
};
|
||||||
|
is.observable = (value) => {
|
||||||
|
var _a, _b, _c, _d;
|
||||||
|
if (!value) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
// eslint-disable-next-line no-use-extend-native/no-use-extend-native
|
||||||
|
if (value === ((_b = (_a = value)[Symbol.observable]) === null || _b === void 0 ? void 0 : _b.call(_a))) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
if (value === ((_d = (_c = value)['@@observable']) === null || _d === void 0 ? void 0 : _d.call(_c))) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
};
|
||||||
|
is.nodeStream = (value) => is.object(value) && is.function_(value.pipe) && !is.observable(value);
|
||||||
|
is.infinite = (value) => value === Infinity || value === -Infinity;
|
||||||
|
const isAbsoluteMod2 = (remainder) => (value) => is.integer(value) && Math.abs(value % 2) === remainder;
|
||||||
|
is.evenInteger = isAbsoluteMod2(0);
|
||||||
|
is.oddInteger = isAbsoluteMod2(1);
|
||||||
|
is.emptyArray = (value) => is.array(value) && value.length === 0;
|
||||||
|
is.nonEmptyArray = (value) => is.array(value) && value.length > 0;
|
||||||
|
is.emptyString = (value) => is.string(value) && value.length === 0;
|
||||||
|
const isWhiteSpaceString = (value) => is.string(value) && !/\S/.test(value);
|
||||||
|
is.emptyStringOrWhitespace = (value) => is.emptyString(value) || isWhiteSpaceString(value);
|
||||||
|
// TODO: Use `not ''` when the `not` operator is available.
|
||||||
|
is.nonEmptyString = (value) => is.string(value) && value.length > 0;
|
||||||
|
// TODO: Use `not ''` when the `not` operator is available.
|
||||||
|
is.nonEmptyStringAndNotWhitespace = (value) => is.string(value) && !is.emptyStringOrWhitespace(value);
|
||||||
|
is.emptyObject = (value) => is.object(value) && !is.map(value) && !is.set(value) && Object.keys(value).length === 0;
|
||||||
|
// TODO: Use `not` operator here to remove `Map` and `Set` from type guard:
|
||||||
|
// - https://github.com/Microsoft/TypeScript/pull/29317
|
||||||
|
is.nonEmptyObject = (value) => is.object(value) && !is.map(value) && !is.set(value) && Object.keys(value).length > 0;
|
||||||
|
is.emptySet = (value) => is.set(value) && value.size === 0;
|
||||||
|
is.nonEmptySet = (value) => is.set(value) && value.size > 0;
|
||||||
|
is.emptyMap = (value) => is.map(value) && value.size === 0;
|
||||||
|
is.nonEmptyMap = (value) => is.map(value) && value.size > 0;
|
||||||
|
// `PropertyKey` is any value that can be used as an object key (string, number, or symbol)
|
||||||
|
is.propertyKey = (value) => is.any([is.string, is.number, is.symbol], value);
|
||||||
|
is.formData = (value) => isObjectOfType('FormData')(value);
|
||||||
|
is.urlSearchParams = (value) => isObjectOfType('URLSearchParams')(value);
|
||||||
|
const predicateOnArray = (method, predicate, values) => {
|
||||||
|
if (!is.function_(predicate)) {
|
||||||
|
throw new TypeError(`Invalid predicate: ${JSON.stringify(predicate)}`);
|
||||||
|
}
|
||||||
|
if (values.length === 0) {
|
||||||
|
throw new TypeError('Invalid number of values');
|
||||||
|
}
|
||||||
|
return method.call(values, predicate);
|
||||||
|
};
|
||||||
|
is.any = (predicate, ...values) => {
|
||||||
|
const predicates = is.array(predicate) ? predicate : [predicate];
|
||||||
|
return predicates.some(singlePredicate => predicateOnArray(Array.prototype.some, singlePredicate, values));
|
||||||
|
};
|
||||||
|
is.all = (predicate, ...values) => predicateOnArray(Array.prototype.every, predicate, values);
|
||||||
|
const assertType = (condition, description, value, options = {}) => {
|
||||||
|
if (!condition) {
|
||||||
|
const { multipleValues } = options;
|
||||||
|
const valuesMessage = multipleValues ?
|
||||||
|
`received values of types ${[
|
||||||
|
...new Set(value.map(singleValue => `\`${is(singleValue)}\``))
|
||||||
|
].join(', ')}` :
|
||||||
|
`received value of type \`${is(value)}\``;
|
||||||
|
throw new TypeError(`Expected value which is \`${description}\`, ${valuesMessage}.`);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
exports.assert = {
|
||||||
|
// Unknowns.
|
||||||
|
undefined: (value) => assertType(is.undefined(value), 'undefined', value),
|
||||||
|
string: (value) => assertType(is.string(value), 'string', value),
|
||||||
|
number: (value) => assertType(is.number(value), 'number', value),
|
||||||
|
bigint: (value) => assertType(is.bigint(value), 'bigint', value),
|
||||||
|
// eslint-disable-next-line @typescript-eslint/ban-types
|
||||||
|
function_: (value) => assertType(is.function_(value), 'Function', value),
|
||||||
|
null_: (value) => assertType(is.null_(value), 'null', value),
|
||||||
|
class_: (value) => assertType(is.class_(value), "Class" /* class_ */, value),
|
||||||
|
boolean: (value) => assertType(is.boolean(value), 'boolean', value),
|
||||||
|
symbol: (value) => assertType(is.symbol(value), 'symbol', value),
|
||||||
|
numericString: (value) => assertType(is.numericString(value), "string with a number" /* numericString */, value),
|
||||||
|
array: (value, assertion) => {
|
||||||
|
const assert = assertType;
|
||||||
|
assert(is.array(value), 'Array', value);
|
||||||
|
if (assertion) {
|
||||||
|
value.forEach(assertion);
|
||||||
|
}
|
||||||
|
},
|
||||||
|
buffer: (value) => assertType(is.buffer(value), 'Buffer', value),
|
||||||
|
blob: (value) => assertType(is.blob(value), 'Blob', value),
|
||||||
|
nullOrUndefined: (value) => assertType(is.nullOrUndefined(value), "null or undefined" /* nullOrUndefined */, value),
|
||||||
|
object: (value) => assertType(is.object(value), 'Object', value),
|
||||||
|
iterable: (value) => assertType(is.iterable(value), "Iterable" /* iterable */, value),
|
||||||
|
asyncIterable: (value) => assertType(is.asyncIterable(value), "AsyncIterable" /* asyncIterable */, value),
|
||||||
|
generator: (value) => assertType(is.generator(value), 'Generator', value),
|
||||||
|
asyncGenerator: (value) => assertType(is.asyncGenerator(value), 'AsyncGenerator', value),
|
||||||
|
nativePromise: (value) => assertType(is.nativePromise(value), "native Promise" /* nativePromise */, value),
|
||||||
|
promise: (value) => assertType(is.promise(value), 'Promise', value),
|
||||||
|
generatorFunction: (value) => assertType(is.generatorFunction(value), 'GeneratorFunction', value),
|
||||||
|
asyncGeneratorFunction: (value) => assertType(is.asyncGeneratorFunction(value), 'AsyncGeneratorFunction', value),
|
||||||
|
// eslint-disable-next-line @typescript-eslint/ban-types
|
||||||
|
asyncFunction: (value) => assertType(is.asyncFunction(value), 'AsyncFunction', value),
|
||||||
|
// eslint-disable-next-line @typescript-eslint/ban-types
|
||||||
|
boundFunction: (value) => assertType(is.boundFunction(value), 'Function', value),
|
||||||
|
regExp: (value) => assertType(is.regExp(value), 'RegExp', value),
|
||||||
|
date: (value) => assertType(is.date(value), 'Date', value),
|
||||||
|
error: (value) => assertType(is.error(value), 'Error', value),
|
||||||
|
map: (value) => assertType(is.map(value), 'Map', value),
|
||||||
|
set: (value) => assertType(is.set(value), 'Set', value),
|
||||||
|
weakMap: (value) => assertType(is.weakMap(value), 'WeakMap', value),
|
||||||
|
weakSet: (value) => assertType(is.weakSet(value), 'WeakSet', value),
|
||||||
|
int8Array: (value) => assertType(is.int8Array(value), 'Int8Array', value),
|
||||||
|
uint8Array: (value) => assertType(is.uint8Array(value), 'Uint8Array', value),
|
||||||
|
uint8ClampedArray: (value) => assertType(is.uint8ClampedArray(value), 'Uint8ClampedArray', value),
|
||||||
|
int16Array: (value) => assertType(is.int16Array(value), 'Int16Array', value),
|
||||||
|
uint16Array: (value) => assertType(is.uint16Array(value), 'Uint16Array', value),
|
||||||
|
int32Array: (value) => assertType(is.int32Array(value), 'Int32Array', value),
|
||||||
|
uint32Array: (value) => assertType(is.uint32Array(value), 'Uint32Array', value),
|
||||||
|
float32Array: (value) => assertType(is.float32Array(value), 'Float32Array', value),
|
||||||
|
float64Array: (value) => assertType(is.float64Array(value), 'Float64Array', value),
|
||||||
|
bigInt64Array: (value) => assertType(is.bigInt64Array(value), 'BigInt64Array', value),
|
||||||
|
bigUint64Array: (value) => assertType(is.bigUint64Array(value), 'BigUint64Array', value),
|
||||||
|
arrayBuffer: (value) => assertType(is.arrayBuffer(value), 'ArrayBuffer', value),
|
||||||
|
sharedArrayBuffer: (value) => assertType(is.sharedArrayBuffer(value), 'SharedArrayBuffer', value),
|
||||||
|
dataView: (value) => assertType(is.dataView(value), 'DataView', value),
|
||||||
|
enumCase: (value, targetEnum) => assertType(is.enumCase(value, targetEnum), 'EnumCase', value),
|
||||||
|
urlInstance: (value) => assertType(is.urlInstance(value), 'URL', value),
|
||||||
|
urlString: (value) => assertType(is.urlString(value), "string with a URL" /* urlString */, value),
|
||||||
|
truthy: (value) => assertType(is.truthy(value), "truthy" /* truthy */, value),
|
||||||
|
falsy: (value) => assertType(is.falsy(value), "falsy" /* falsy */, value),
|
||||||
|
nan: (value) => assertType(is.nan(value), "NaN" /* nan */, value),
|
||||||
|
primitive: (value) => assertType(is.primitive(value), "primitive" /* primitive */, value),
|
||||||
|
integer: (value) => assertType(is.integer(value), "integer" /* integer */, value),
|
||||||
|
safeInteger: (value) => assertType(is.safeInteger(value), "integer" /* safeInteger */, value),
|
||||||
|
plainObject: (value) => assertType(is.plainObject(value), "plain object" /* plainObject */, value),
|
||||||
|
typedArray: (value) => assertType(is.typedArray(value), "TypedArray" /* typedArray */, value),
|
||||||
|
arrayLike: (value) => assertType(is.arrayLike(value), "array-like" /* arrayLike */, value),
|
||||||
|
domElement: (value) => assertType(is.domElement(value), "HTMLElement" /* domElement */, value),
|
||||||
|
observable: (value) => assertType(is.observable(value), 'Observable', value),
|
||||||
|
nodeStream: (value) => assertType(is.nodeStream(value), "Node.js Stream" /* nodeStream */, value),
|
||||||
|
infinite: (value) => assertType(is.infinite(value), "infinite number" /* infinite */, value),
|
||||||
|
emptyArray: (value) => assertType(is.emptyArray(value), "empty array" /* emptyArray */, value),
|
||||||
|
nonEmptyArray: (value) => assertType(is.nonEmptyArray(value), "non-empty array" /* nonEmptyArray */, value),
|
||||||
|
emptyString: (value) => assertType(is.emptyString(value), "empty string" /* emptyString */, value),
|
||||||
|
emptyStringOrWhitespace: (value) => assertType(is.emptyStringOrWhitespace(value), "empty string or whitespace" /* emptyStringOrWhitespace */, value),
|
||||||
|
nonEmptyString: (value) => assertType(is.nonEmptyString(value), "non-empty string" /* nonEmptyString */, value),
|
||||||
|
nonEmptyStringAndNotWhitespace: (value) => assertType(is.nonEmptyStringAndNotWhitespace(value), "non-empty string and not whitespace" /* nonEmptyStringAndNotWhitespace */, value),
|
||||||
|
emptyObject: (value) => assertType(is.emptyObject(value), "empty object" /* emptyObject */, value),
|
||||||
|
nonEmptyObject: (value) => assertType(is.nonEmptyObject(value), "non-empty object" /* nonEmptyObject */, value),
|
||||||
|
emptySet: (value) => assertType(is.emptySet(value), "empty set" /* emptySet */, value),
|
||||||
|
nonEmptySet: (value) => assertType(is.nonEmptySet(value), "non-empty set" /* nonEmptySet */, value),
|
||||||
|
emptyMap: (value) => assertType(is.emptyMap(value), "empty map" /* emptyMap */, value),
|
||||||
|
nonEmptyMap: (value) => assertType(is.nonEmptyMap(value), "non-empty map" /* nonEmptyMap */, value),
|
||||||
|
propertyKey: (value) => assertType(is.propertyKey(value), 'PropertyKey', value),
|
||||||
|
formData: (value) => assertType(is.formData(value), 'FormData', value),
|
||||||
|
urlSearchParams: (value) => assertType(is.urlSearchParams(value), 'URLSearchParams', value),
|
||||||
|
// Numbers.
|
||||||
|
evenInteger: (value) => assertType(is.evenInteger(value), "even integer" /* evenInteger */, value),
|
||||||
|
oddInteger: (value) => assertType(is.oddInteger(value), "odd integer" /* oddInteger */, value),
|
||||||
|
// Two arguments.
|
||||||
|
directInstanceOf: (instance, class_) => assertType(is.directInstanceOf(instance, class_), "T" /* directInstanceOf */, instance),
|
||||||
|
inRange: (value, range) => assertType(is.inRange(value, range), "in range" /* inRange */, value),
|
||||||
|
// Variadic functions.
|
||||||
|
any: (predicate, ...values) => {
|
||||||
|
return assertType(is.any(predicate, ...values), "predicate returns truthy for any value" /* any */, values, { multipleValues: true });
|
||||||
|
},
|
||||||
|
all: (predicate, ...values) => assertType(is.all(predicate, ...values), "predicate returns truthy for all values" /* all */, values, { multipleValues: true })
|
||||||
|
};
|
||||||
|
// Some few keywords are reserved, but we'll populate them for Node.js users
|
||||||
|
// See https://github.com/Microsoft/TypeScript/issues/2536
|
||||||
|
Object.defineProperties(is, {
|
||||||
|
class: {
|
||||||
|
value: is.class_
|
||||||
|
},
|
||||||
|
function: {
|
||||||
|
value: is.function_
|
||||||
|
},
|
||||||
|
null: {
|
||||||
|
value: is.null_
|
||||||
|
}
|
||||||
|
});
|
||||||
|
Object.defineProperties(exports.assert, {
|
||||||
|
class: {
|
||||||
|
value: exports.assert.class_
|
||||||
|
},
|
||||||
|
function: {
|
||||||
|
value: exports.assert.function_
|
||||||
|
},
|
||||||
|
null: {
|
||||||
|
value: exports.assert.null_
|
||||||
|
}
|
||||||
|
});
|
||||||
|
exports.default = is;
|
||||||
|
// For CommonJS default export support
|
||||||
|
module.exports = is;
|
||||||
|
module.exports.default = is;
|
||||||
|
module.exports.assert = exports.assert;
|
||||||
+25
@@ -0,0 +1,25 @@
|
|||||||
|
/**
|
||||||
|
Matches any [primitive value](https://developer.mozilla.org/en-US/docs/Glossary/Primitive).
|
||||||
|
*/
|
||||||
|
export declare type Primitive = null | undefined | string | number | boolean | symbol | bigint;
|
||||||
|
/**
|
||||||
|
Matches a [`class` constructor](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes).
|
||||||
|
*/
|
||||||
|
export declare type Class<T = unknown, Arguments extends any[] = any[]> = new (...arguments_: Arguments) => T;
|
||||||
|
/**
|
||||||
|
Matches any [typed array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray), like `Uint8Array` or `Float64Array`.
|
||||||
|
*/
|
||||||
|
export declare type TypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array | BigInt64Array | BigUint64Array;
|
||||||
|
declare global {
|
||||||
|
interface SymbolConstructor {
|
||||||
|
readonly observable: symbol;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
Matches a value that is like an [Observable](https://github.com/tc39/proposal-observable).
|
||||||
|
*/
|
||||||
|
export interface ObservableLike {
|
||||||
|
subscribe(observer: (value: unknown) => void): void;
|
||||||
|
[Symbol.observable](): ObservableLike;
|
||||||
|
}
|
||||||
|
export declare type Falsy = false | 0 | 0n | '' | null | undefined;
|
||||||
+3
@@ -0,0 +1,3 @@
|
|||||||
|
"use strict";
|
||||||
|
// Extracted from https://github.com/sindresorhus/type-fest/blob/78019f42ea888b0cdceb41a4a78163868de57555/index.d.ts
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
+9
@@ -0,0 +1,9 @@
|
|||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||||
+96
@@ -0,0 +1,96 @@
|
|||||||
|
{
|
||||||
|
"name": "@sindresorhus/is",
|
||||||
|
"version": "4.6.0",
|
||||||
|
"description": "Type check values",
|
||||||
|
"license": "MIT",
|
||||||
|
"repository": "sindresorhus/is",
|
||||||
|
"funding": "https://github.com/sindresorhus/is?sponsor=1",
|
||||||
|
"author": {
|
||||||
|
"name": "Sindre Sorhus",
|
||||||
|
"email": "sindresorhus@gmail.com",
|
||||||
|
"url": "https://sindresorhus.com"
|
||||||
|
},
|
||||||
|
"main": "dist/index.js",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"build": "del dist && tsc",
|
||||||
|
"test": "xo && ava",
|
||||||
|
"prepare": "npm run build"
|
||||||
|
},
|
||||||
|
"files": [
|
||||||
|
"dist"
|
||||||
|
],
|
||||||
|
"keywords": [
|
||||||
|
"type",
|
||||||
|
"types",
|
||||||
|
"is",
|
||||||
|
"check",
|
||||||
|
"checking",
|
||||||
|
"validate",
|
||||||
|
"validation",
|
||||||
|
"utility",
|
||||||
|
"util",
|
||||||
|
"typeof",
|
||||||
|
"instanceof",
|
||||||
|
"object",
|
||||||
|
"assert",
|
||||||
|
"assertion",
|
||||||
|
"test",
|
||||||
|
"kind",
|
||||||
|
"primitive",
|
||||||
|
"verify",
|
||||||
|
"compare",
|
||||||
|
"typescript",
|
||||||
|
"typeguards",
|
||||||
|
"types"
|
||||||
|
],
|
||||||
|
"devDependencies": {
|
||||||
|
"@sindresorhus/tsconfig": "^0.7.0",
|
||||||
|
"@types/jsdom": "^16.1.0",
|
||||||
|
"@types/node": "^14.0.13",
|
||||||
|
"@types/zen-observable": "^0.8.0",
|
||||||
|
"@typescript-eslint/eslint-plugin": "^2.20.0",
|
||||||
|
"@typescript-eslint/parser": "^2.20.0",
|
||||||
|
"ava": "^3.3.0",
|
||||||
|
"del-cli": "^2.0.0",
|
||||||
|
"eslint-config-xo-typescript": "^0.26.0",
|
||||||
|
"jsdom": "^16.0.1",
|
||||||
|
"rxjs": "^6.4.0",
|
||||||
|
"tempy": "^0.4.0",
|
||||||
|
"ts-node": "^8.3.0",
|
||||||
|
"typescript": "~3.8.2",
|
||||||
|
"xo": "^0.26.1",
|
||||||
|
"zen-observable": "^0.8.8"
|
||||||
|
},
|
||||||
|
"types": "dist/index.d.ts",
|
||||||
|
"sideEffects": false,
|
||||||
|
"ava": {
|
||||||
|
"extensions": [
|
||||||
|
"ts"
|
||||||
|
],
|
||||||
|
"require": [
|
||||||
|
"ts-node/register"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"xo": {
|
||||||
|
"extends": "xo-typescript",
|
||||||
|
"extensions": [
|
||||||
|
"ts"
|
||||||
|
],
|
||||||
|
"parserOptions": {
|
||||||
|
"project": "./tsconfig.xo.json"
|
||||||
|
},
|
||||||
|
"globals": [
|
||||||
|
"BigInt",
|
||||||
|
"BigInt64Array",
|
||||||
|
"BigUint64Array"
|
||||||
|
],
|
||||||
|
"rules": {
|
||||||
|
"@typescript-eslint/promise-function-async": "off",
|
||||||
|
"@typescript-eslint/no-empty-function": "off",
|
||||||
|
"@typescript-eslint/explicit-function-return-type": "off"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
+669
@@ -0,0 +1,669 @@
|
|||||||
|
# is
|
||||||
|
|
||||||
|
> Type check values
|
||||||
|
|
||||||
|
For example, `is.string('🦄') //=> true`
|
||||||
|
|
||||||
|
<img src="header.gif" width="182" align="right">
|
||||||
|
|
||||||
|
## Highlights
|
||||||
|
|
||||||
|
- Written in TypeScript
|
||||||
|
- [Extensive use of type guards](#type-guards)
|
||||||
|
- [Supports type assertions](#type-assertions)
|
||||||
|
- [Aware of generic type parameters](#generic-type-parameters) (use with caution)
|
||||||
|
- Actively maintained
|
||||||
|
- 
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
```sh
|
||||||
|
npm install @sindresorhus/is
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```js
|
||||||
|
const is = require('@sindresorhus/is');
|
||||||
|
|
||||||
|
is('🦄');
|
||||||
|
//=> 'string'
|
||||||
|
|
||||||
|
is(new Map());
|
||||||
|
//=> 'Map'
|
||||||
|
|
||||||
|
is.number(6);
|
||||||
|
//=> true
|
||||||
|
```
|
||||||
|
|
||||||
|
[Assertions](#type-assertions) perform the same type checks, but throw an error if the type does not match.
|
||||||
|
|
||||||
|
```js
|
||||||
|
const {assert} = require('@sindresorhus/is');
|
||||||
|
|
||||||
|
assert.string(2);
|
||||||
|
//=> Error: Expected value which is `string`, received value of type `number`.
|
||||||
|
```
|
||||||
|
|
||||||
|
And with TypeScript:
|
||||||
|
|
||||||
|
```ts
|
||||||
|
import {assert} from '@sindresorhus/is';
|
||||||
|
|
||||||
|
assert.string(foo);
|
||||||
|
// `foo` is now typed as a `string`.
|
||||||
|
```
|
||||||
|
|
||||||
|
## API
|
||||||
|
|
||||||
|
### is(value)
|
||||||
|
|
||||||
|
Returns the type of `value`.
|
||||||
|
|
||||||
|
Primitives are lowercase and object types are camelcase.
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
- `'undefined'`
|
||||||
|
- `'null'`
|
||||||
|
- `'string'`
|
||||||
|
- `'symbol'`
|
||||||
|
- `'Array'`
|
||||||
|
- `'Function'`
|
||||||
|
- `'Object'`
|
||||||
|
|
||||||
|
Note: It will throw an error if you try to feed it object-wrapped primitives, as that's a bad practice. For example `new String('foo')`.
|
||||||
|
|
||||||
|
### is.{method}
|
||||||
|
|
||||||
|
All the below methods accept a value and returns a boolean for whether the value is of the desired type.
|
||||||
|
|
||||||
|
#### Primitives
|
||||||
|
|
||||||
|
##### .undefined(value)
|
||||||
|
##### .null(value)
|
||||||
|
|
||||||
|
**Note:** TypeScript users must use `.null_()` because of a TypeScript naming limitation.
|
||||||
|
|
||||||
|
##### .string(value)
|
||||||
|
##### .number(value)
|
||||||
|
|
||||||
|
Note: `is.number(NaN)` returns `false`. This intentionally deviates from `typeof` behavior to increase user-friendliness of `is` type checks.
|
||||||
|
|
||||||
|
##### .boolean(value)
|
||||||
|
##### .symbol(value)
|
||||||
|
##### .bigint(value)
|
||||||
|
|
||||||
|
#### Built-in types
|
||||||
|
|
||||||
|
##### .array(value, assertion?)
|
||||||
|
|
||||||
|
Returns true if `value` is an array and all of its items match the assertion (if provided).
|
||||||
|
|
||||||
|
```js
|
||||||
|
is.array(value); // Validate `value` is an array.
|
||||||
|
is.array(value, is.number); // Validate `value` is an array and all of its items are numbers.
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .function(value)
|
||||||
|
|
||||||
|
**Note:** TypeScript users must use `.function_()` because of a TypeScript naming limitation.
|
||||||
|
|
||||||
|
##### .buffer(value)
|
||||||
|
##### .blob(value)
|
||||||
|
##### .object(value)
|
||||||
|
|
||||||
|
Keep in mind that [functions are objects too](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions).
|
||||||
|
|
||||||
|
##### .numericString(value)
|
||||||
|
|
||||||
|
Returns `true` for a string that represents a number satisfying `is.number`, for example, `'42'` and `'-8.3'`.
|
||||||
|
|
||||||
|
Note: `'NaN'` returns `false`, but `'Infinity'` and `'-Infinity'` return `true`.
|
||||||
|
|
||||||
|
##### .regExp(value)
|
||||||
|
##### .date(value)
|
||||||
|
##### .error(value)
|
||||||
|
##### .nativePromise(value)
|
||||||
|
##### .promise(value)
|
||||||
|
|
||||||
|
Returns `true` for any object with a `.then()` and `.catch()` method. Prefer this one over `.nativePromise()` as you usually want to allow userland promise implementations too.
|
||||||
|
|
||||||
|
##### .generator(value)
|
||||||
|
|
||||||
|
Returns `true` for any object that implements its own `.next()` and `.throw()` methods and has a function definition for `Symbol.iterator`.
|
||||||
|
|
||||||
|
##### .generatorFunction(value)
|
||||||
|
|
||||||
|
##### .asyncFunction(value)
|
||||||
|
|
||||||
|
Returns `true` for any `async` function that can be called with the `await` operator.
|
||||||
|
|
||||||
|
```js
|
||||||
|
is.asyncFunction(async () => {});
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
is.asyncFunction(() => {});
|
||||||
|
//=> false
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .asyncGenerator(value)
|
||||||
|
|
||||||
|
```js
|
||||||
|
is.asyncGenerator(
|
||||||
|
(async function * () {
|
||||||
|
yield 4;
|
||||||
|
})()
|
||||||
|
);
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
is.asyncGenerator(
|
||||||
|
(function * () {
|
||||||
|
yield 4;
|
||||||
|
})()
|
||||||
|
);
|
||||||
|
//=> false
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .asyncGeneratorFunction(value)
|
||||||
|
|
||||||
|
```js
|
||||||
|
is.asyncGeneratorFunction(async function * () {
|
||||||
|
yield 4;
|
||||||
|
});
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
is.asyncGeneratorFunction(function * () {
|
||||||
|
yield 4;
|
||||||
|
});
|
||||||
|
//=> false
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .boundFunction(value)
|
||||||
|
|
||||||
|
Returns `true` for any `bound` function.
|
||||||
|
|
||||||
|
```js
|
||||||
|
is.boundFunction(() => {});
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
is.boundFunction(function () {}.bind(null));
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
is.boundFunction(function () {});
|
||||||
|
//=> false
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .map(value)
|
||||||
|
##### .set(value)
|
||||||
|
##### .weakMap(value)
|
||||||
|
##### .weakSet(value)
|
||||||
|
|
||||||
|
#### Typed arrays
|
||||||
|
|
||||||
|
##### .int8Array(value)
|
||||||
|
##### .uint8Array(value)
|
||||||
|
##### .uint8ClampedArray(value)
|
||||||
|
##### .int16Array(value)
|
||||||
|
##### .uint16Array(value)
|
||||||
|
##### .int32Array(value)
|
||||||
|
##### .uint32Array(value)
|
||||||
|
##### .float32Array(value)
|
||||||
|
##### .float64Array(value)
|
||||||
|
##### .bigInt64Array(value)
|
||||||
|
##### .bigUint64Array(value)
|
||||||
|
|
||||||
|
#### Structured data
|
||||||
|
|
||||||
|
##### .arrayBuffer(value)
|
||||||
|
##### .sharedArrayBuffer(value)
|
||||||
|
##### .dataView(value)
|
||||||
|
|
||||||
|
##### .enumCase(value, enum)
|
||||||
|
|
||||||
|
TypeScript-only. Returns `true` if `value` is a member of `enum`.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
enum Direction {
|
||||||
|
Ascending = 'ascending',
|
||||||
|
Descending = 'descending'
|
||||||
|
}
|
||||||
|
|
||||||
|
is.enumCase('ascending', Direction);
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
is.enumCase('other', Direction);
|
||||||
|
//=> false
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Emptiness
|
||||||
|
|
||||||
|
##### .emptyString(value)
|
||||||
|
|
||||||
|
Returns `true` if the value is a `string` and the `.length` is 0.
|
||||||
|
|
||||||
|
##### .emptyStringOrWhitespace(value)
|
||||||
|
|
||||||
|
Returns `true` if `is.emptyString(value)` or if it's a `string` that is all whitespace.
|
||||||
|
|
||||||
|
##### .nonEmptyString(value)
|
||||||
|
|
||||||
|
Returns `true` if the value is a `string` and the `.length` is more than 0.
|
||||||
|
|
||||||
|
##### .nonEmptyStringAndNotWhitespace(value)
|
||||||
|
|
||||||
|
Returns `true` if the value is a `string` that is not empty and not whitespace.
|
||||||
|
|
||||||
|
```js
|
||||||
|
const values = ['property1', '', null, 'property2', ' ', undefined];
|
||||||
|
|
||||||
|
values.filter(is.nonEmptyStringAndNotWhitespace);
|
||||||
|
//=> ['property1', 'property2']
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .emptyArray(value)
|
||||||
|
|
||||||
|
Returns `true` if the value is an `Array` and the `.length` is 0.
|
||||||
|
|
||||||
|
##### .nonEmptyArray(value)
|
||||||
|
|
||||||
|
Returns `true` if the value is an `Array` and the `.length` is more than 0.
|
||||||
|
|
||||||
|
##### .emptyObject(value)
|
||||||
|
|
||||||
|
Returns `true` if the value is an `Object` and `Object.keys(value).length` is 0.
|
||||||
|
|
||||||
|
Please note that `Object.keys` returns only own enumerable properties. Hence something like this can happen:
|
||||||
|
|
||||||
|
```js
|
||||||
|
const object1 = {};
|
||||||
|
|
||||||
|
Object.defineProperty(object1, 'property1', {
|
||||||
|
value: 42,
|
||||||
|
writable: true,
|
||||||
|
enumerable: false,
|
||||||
|
configurable: true
|
||||||
|
});
|
||||||
|
|
||||||
|
is.emptyObject(object1);
|
||||||
|
//=> true
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .nonEmptyObject(value)
|
||||||
|
|
||||||
|
Returns `true` if the value is an `Object` and `Object.keys(value).length` is more than 0.
|
||||||
|
|
||||||
|
##### .emptySet(value)
|
||||||
|
|
||||||
|
Returns `true` if the value is a `Set` and the `.size` is 0.
|
||||||
|
|
||||||
|
##### .nonEmptySet(Value)
|
||||||
|
|
||||||
|
Returns `true` if the value is a `Set` and the `.size` is more than 0.
|
||||||
|
|
||||||
|
##### .emptyMap(value)
|
||||||
|
|
||||||
|
Returns `true` if the value is a `Map` and the `.size` is 0.
|
||||||
|
|
||||||
|
##### .nonEmptyMap(value)
|
||||||
|
|
||||||
|
Returns `true` if the value is a `Map` and the `.size` is more than 0.
|
||||||
|
|
||||||
|
#### Miscellaneous
|
||||||
|
|
||||||
|
##### .directInstanceOf(value, class)
|
||||||
|
|
||||||
|
Returns `true` if `value` is a direct instance of `class`.
|
||||||
|
|
||||||
|
```js
|
||||||
|
is.directInstanceOf(new Error(), Error);
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
class UnicornError extends Error {}
|
||||||
|
|
||||||
|
is.directInstanceOf(new UnicornError(), Error);
|
||||||
|
//=> false
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .urlInstance(value)
|
||||||
|
|
||||||
|
Returns `true` if `value` is an instance of the [`URL` class](https://developer.mozilla.org/en-US/docs/Web/API/URL).
|
||||||
|
|
||||||
|
```js
|
||||||
|
const url = new URL('https://example.com');
|
||||||
|
|
||||||
|
is.urlInstance(url);
|
||||||
|
//=> true
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .urlString(value)
|
||||||
|
|
||||||
|
Returns `true` if `value` is a URL string.
|
||||||
|
|
||||||
|
Note: this only does basic checking using the [`URL` class](https://developer.mozilla.org/en-US/docs/Web/API/URL) constructor.
|
||||||
|
|
||||||
|
```js
|
||||||
|
const url = 'https://example.com';
|
||||||
|
|
||||||
|
is.urlString(url);
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
is.urlString(new URL(url));
|
||||||
|
//=> false
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .truthy(value)
|
||||||
|
|
||||||
|
Returns `true` for all values that evaluate to true in a boolean context:
|
||||||
|
|
||||||
|
```js
|
||||||
|
is.truthy('🦄');
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
is.truthy(undefined);
|
||||||
|
//=> false
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .falsy(value)
|
||||||
|
|
||||||
|
Returns `true` if `value` is one of: `false`, `0`, `''`, `null`, `undefined`, `NaN`.
|
||||||
|
|
||||||
|
##### .nan(value)
|
||||||
|
##### .nullOrUndefined(value)
|
||||||
|
##### .primitive(value)
|
||||||
|
|
||||||
|
JavaScript primitives are as follows: `null`, `undefined`, `string`, `number`, `boolean`, `symbol`.
|
||||||
|
|
||||||
|
##### .integer(value)
|
||||||
|
|
||||||
|
##### .safeInteger(value)
|
||||||
|
|
||||||
|
Returns `true` if `value` is a [safe integer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/isSafeInteger).
|
||||||
|
|
||||||
|
##### .plainObject(value)
|
||||||
|
|
||||||
|
An object is plain if it's created by either `{}`, `new Object()`, or `Object.create(null)`.
|
||||||
|
|
||||||
|
##### .iterable(value)
|
||||||
|
##### .asyncIterable(value)
|
||||||
|
##### .class(value)
|
||||||
|
|
||||||
|
Returns `true` for instances created by a class.
|
||||||
|
|
||||||
|
**Note:** TypeScript users must use `.class_()` because of a TypeScript naming limitation.
|
||||||
|
|
||||||
|
##### .typedArray(value)
|
||||||
|
|
||||||
|
##### .arrayLike(value)
|
||||||
|
|
||||||
|
A `value` is array-like if it is not a function and has a `value.length` that is a safe integer greater than or equal to 0.
|
||||||
|
|
||||||
|
```js
|
||||||
|
is.arrayLike(document.forms);
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
function foo() {
|
||||||
|
is.arrayLike(arguments);
|
||||||
|
//=> true
|
||||||
|
}
|
||||||
|
foo();
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .inRange(value, range)
|
||||||
|
|
||||||
|
Check if `value` (number) is in the given `range`. The range is an array of two values, lower bound and upper bound, in no specific order.
|
||||||
|
|
||||||
|
```js
|
||||||
|
is.inRange(3, [0, 5]);
|
||||||
|
is.inRange(3, [5, 0]);
|
||||||
|
is.inRange(0, [-2, 2]);
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .inRange(value, upperBound)
|
||||||
|
|
||||||
|
Check if `value` (number) is in the range of `0` to `upperBound`.
|
||||||
|
|
||||||
|
```js
|
||||||
|
is.inRange(3, 10);
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .domElement(value)
|
||||||
|
|
||||||
|
Returns `true` if `value` is a DOM Element.
|
||||||
|
|
||||||
|
##### .nodeStream(value)
|
||||||
|
|
||||||
|
Returns `true` if `value` is a Node.js [stream](https://nodejs.org/api/stream.html).
|
||||||
|
|
||||||
|
```js
|
||||||
|
const fs = require('fs');
|
||||||
|
|
||||||
|
is.nodeStream(fs.createReadStream('unicorn.png'));
|
||||||
|
//=> true
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .observable(value)
|
||||||
|
|
||||||
|
Returns `true` if `value` is an `Observable`.
|
||||||
|
|
||||||
|
```js
|
||||||
|
const {Observable} = require('rxjs');
|
||||||
|
|
||||||
|
is.observable(new Observable());
|
||||||
|
//=> true
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .infinite(value)
|
||||||
|
|
||||||
|
Check if `value` is `Infinity` or `-Infinity`.
|
||||||
|
|
||||||
|
##### .evenInteger(value)
|
||||||
|
|
||||||
|
Returns `true` if `value` is an even integer.
|
||||||
|
|
||||||
|
##### .oddInteger(value)
|
||||||
|
|
||||||
|
Returns `true` if `value` is an odd integer.
|
||||||
|
|
||||||
|
##### .propertyKey(value)
|
||||||
|
|
||||||
|
Returns `true` if `value` can be used as an object property key (either `string`, `number`, or `symbol`).
|
||||||
|
|
||||||
|
##### .formData(value)
|
||||||
|
|
||||||
|
Returns `true` if `value` is an instance of the [`FormData` class](https://developer.mozilla.org/en-US/docs/Web/API/FormData).
|
||||||
|
|
||||||
|
```js
|
||||||
|
const data = new FormData();
|
||||||
|
|
||||||
|
is.formData(data);
|
||||||
|
//=> true
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .urlSearchParams(value)
|
||||||
|
|
||||||
|
Returns `true` if `value` is an instance of the [`URLSearchParams` class](https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams).
|
||||||
|
|
||||||
|
```js
|
||||||
|
const searchParams = new URLSearchParams();
|
||||||
|
|
||||||
|
is.urlSearchParams(searchParams);
|
||||||
|
//=> true
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .any(predicate | predicate[], ...values)
|
||||||
|
|
||||||
|
Using a single `predicate` argument, returns `true` if **any** of the input `values` returns true in the `predicate`:
|
||||||
|
|
||||||
|
```js
|
||||||
|
is.any(is.string, {}, true, '🦄');
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
is.any(is.boolean, 'unicorns', [], new Map());
|
||||||
|
//=> false
|
||||||
|
```
|
||||||
|
|
||||||
|
Using an array of `predicate[]`, returns `true` if **any** of the input `values` returns true for **any** of the `predicates` provided in an array:
|
||||||
|
|
||||||
|
```js
|
||||||
|
is.any([is.string, is.number], {}, true, '🦄');
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
is.any([is.boolean, is.number], 'unicorns', [], new Map());
|
||||||
|
//=> false
|
||||||
|
```
|
||||||
|
|
||||||
|
##### .all(predicate, ...values)
|
||||||
|
|
||||||
|
Returns `true` if **all** of the input `values` returns true in the `predicate`:
|
||||||
|
|
||||||
|
```js
|
||||||
|
is.all(is.object, {}, new Map(), new Set());
|
||||||
|
//=> true
|
||||||
|
|
||||||
|
is.all(is.string, '🦄', [], 'unicorns');
|
||||||
|
//=> false
|
||||||
|
```
|
||||||
|
|
||||||
|
## Type guards
|
||||||
|
|
||||||
|
When using `is` together with TypeScript, [type guards](http://www.typescriptlang.org/docs/handbook/advanced-types.html#type-guards-and-differentiating-types) are being used extensively to infer the correct type inside if-else statements.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
import is from '@sindresorhus/is';
|
||||||
|
|
||||||
|
const padLeft = (value: string, padding: string | number) => {
|
||||||
|
if (is.number(padding)) {
|
||||||
|
// `padding` is typed as `number`
|
||||||
|
return Array(padding + 1).join(' ') + value;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (is.string(padding)) {
|
||||||
|
// `padding` is typed as `string`
|
||||||
|
return padding + value;
|
||||||
|
}
|
||||||
|
|
||||||
|
throw new TypeError(`Expected 'padding' to be of type 'string' or 'number', got '${is(padding)}'.`);
|
||||||
|
}
|
||||||
|
|
||||||
|
padLeft('🦄', 3);
|
||||||
|
//=> ' 🦄'
|
||||||
|
|
||||||
|
padLeft('🦄', '🌈');
|
||||||
|
//=> '🌈🦄'
|
||||||
|
```
|
||||||
|
|
||||||
|
## Type assertions
|
||||||
|
|
||||||
|
The type guards are also available as [type assertions](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-7.html#assertion-functions), which throw an error for unexpected types. It is a convenient one-line version of the often repetitive "if-not-expected-type-throw" pattern.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
import {assert} from '@sindresorhus/is';
|
||||||
|
|
||||||
|
const handleMovieRatingApiResponse = (response: unknown) => {
|
||||||
|
assert.plainObject(response);
|
||||||
|
// `response` is now typed as a plain `object` with `unknown` properties.
|
||||||
|
|
||||||
|
assert.number(response.rating);
|
||||||
|
// `response.rating` is now typed as a `number`.
|
||||||
|
|
||||||
|
assert.string(response.title);
|
||||||
|
// `response.title` is now typed as a `string`.
|
||||||
|
|
||||||
|
return `${response.title} (${response.rating * 10})`;
|
||||||
|
};
|
||||||
|
|
||||||
|
handleMovieRatingApiResponse({rating: 0.87, title: 'The Matrix'});
|
||||||
|
//=> 'The Matrix (8.7)'
|
||||||
|
|
||||||
|
// This throws an error.
|
||||||
|
handleMovieRatingApiResponse({rating: '🦄'});
|
||||||
|
```
|
||||||
|
|
||||||
|
## Generic type parameters
|
||||||
|
|
||||||
|
The type guards and type assertions are aware of [generic type parameters](https://www.typescriptlang.org/docs/handbook/generics.html), such as `Promise<T>` and `Map<Key, Value>`. The default is `unknown` for most cases, since `is` cannot check them at runtime. If the generic type is known at compile-time, either implicitly (inferred) or explicitly (provided), `is` propagates the type so it can be used later.
|
||||||
|
|
||||||
|
Use generic type parameters with caution. They are only checked by the TypeScript compiler, and not checked by `is` at runtime. This can lead to unexpected behavior, where the generic type is _assumed_ at compile-time, but actually is something completely different at runtime. It is best to use `unknown` (default) and type-check the value of the generic type parameter at runtime with `is` or `assert`.
|
||||||
|
|
||||||
|
```ts
|
||||||
|
import {assert} from '@sindresorhus/is';
|
||||||
|
|
||||||
|
async function badNumberAssumption(input: unknown) {
|
||||||
|
// Bad assumption about the generic type parameter fools the compile-time type system.
|
||||||
|
assert.promise<number>(input);
|
||||||
|
// `input` is a `Promise` but only assumed to be `Promise<number>`.
|
||||||
|
|
||||||
|
const resolved = await input;
|
||||||
|
// `resolved` is typed as `number` but was not actually checked at runtime.
|
||||||
|
|
||||||
|
// Multiplication will return NaN if the input promise did not actually contain a number.
|
||||||
|
return 2 * resolved;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function goodNumberAssertion(input: unknown) {
|
||||||
|
assert.promise(input);
|
||||||
|
// `input` is typed as `Promise<unknown>`
|
||||||
|
|
||||||
|
const resolved = await input;
|
||||||
|
// `resolved` is typed as `unknown`
|
||||||
|
|
||||||
|
assert.number(resolved);
|
||||||
|
// `resolved` is typed as `number`
|
||||||
|
|
||||||
|
// Uses runtime checks so only numbers will reach the multiplication.
|
||||||
|
return 2 * resolved;
|
||||||
|
}
|
||||||
|
|
||||||
|
badNumberAssumption(Promise.resolve('An unexpected string'));
|
||||||
|
//=> NaN
|
||||||
|
|
||||||
|
// This correctly throws an error because of the unexpected string value.
|
||||||
|
goodNumberAssertion(Promise.resolve('An unexpected string'));
|
||||||
|
```
|
||||||
|
|
||||||
|
## FAQ
|
||||||
|
|
||||||
|
### Why yet another type checking module?
|
||||||
|
|
||||||
|
There are hundreds of type checking modules on npm, unfortunately, I couldn't find any that fit my needs:
|
||||||
|
|
||||||
|
- Includes both type methods and ability to get the type
|
||||||
|
- Types of primitives returned as lowercase and object types as camelcase
|
||||||
|
- Covers all built-ins
|
||||||
|
- Unsurprising behavior
|
||||||
|
- Well-maintained
|
||||||
|
- Comprehensive test suite
|
||||||
|
|
||||||
|
For the ones I found, pick 3 of these.
|
||||||
|
|
||||||
|
The most common mistakes I noticed in these modules was using `instanceof` for type checking, forgetting that functions are objects, and omitting `symbol` as a primitive.
|
||||||
|
|
||||||
|
### Why not just use `instanceof` instead of this package?
|
||||||
|
|
||||||
|
`instanceof` does not work correctly for all types and it does not work across [realms](https://stackoverflow.com/a/49832343/64949). Examples of realms are iframes, windows, web workers, and the `vm` module in Node.js.
|
||||||
|
|
||||||
|
## For enterprise
|
||||||
|
|
||||||
|
Available as part of the Tidelift Subscription.
|
||||||
|
|
||||||
|
The maintainers of @sindresorhus/is and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. [Learn more.](https://tidelift.com/subscription/pkg/npm-sindresorhus-is?utm_source=npm-sindresorhus-is&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)
|
||||||
|
|
||||||
|
## Related
|
||||||
|
|
||||||
|
- [ow](https://github.com/sindresorhus/ow) - Function argument validation for humans
|
||||||
|
- [is-stream](https://github.com/sindresorhus/is-stream) - Check if something is a Node.js stream
|
||||||
|
- [is-observable](https://github.com/sindresorhus/is-observable) - Check if a value is an Observable
|
||||||
|
- [file-type](https://github.com/sindresorhus/file-type) - Detect the file type of a Buffer/Uint8Array
|
||||||
|
- [is-ip](https://github.com/sindresorhus/is-ip) - Check if a string is an IP address
|
||||||
|
- [is-array-sorted](https://github.com/sindresorhus/is-array-sorted) - Check if an Array is sorted
|
||||||
|
- [is-error-constructor](https://github.com/sindresorhus/is-error-constructor) - Check if a value is an error constructor
|
||||||
|
- [is-empty-iterable](https://github.com/sindresorhus/is-empty-iterable) - Check if an Iterable is empty
|
||||||
|
- [is-blob](https://github.com/sindresorhus/is-blob) - Check if a value is a Blob - File-like object of immutable, raw data
|
||||||
|
- [has-emoji](https://github.com/sindresorhus/has-emoji) - Check whether a string has any emoji
|
||||||
|
|
||||||
|
## Maintainers
|
||||||
|
|
||||||
|
- [Sindre Sorhus](https://github.com/sindresorhus)
|
||||||
|
- [Giora Guttsait](https://github.com/gioragutt)
|
||||||
|
- [Brandon Smith](https://github.com/brandon93s)
|
||||||
+21
@@ -0,0 +1,21 @@
|
|||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) 2018 Szymon Marczak
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE.
|
||||||
+93
@@ -0,0 +1,93 @@
|
|||||||
|
# http-timer
|
||||||
|
> Timings for HTTP requests
|
||||||
|
|
||||||
|
[](https://travis-ci.org/szmarczak/http-timer)
|
||||||
|
[](https://coveralls.io/github/szmarczak/http-timer?branch=master)
|
||||||
|
[](https://packagephobia.now.sh/result?p=@szmarczak/http-timer)
|
||||||
|
|
||||||
|
Inspired by the [`request` package](https://github.com/request/request).
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
NPM:
|
||||||
|
|
||||||
|
> `npm install @szmarczak/http-timer`
|
||||||
|
|
||||||
|
Yarn:
|
||||||
|
|
||||||
|
> `yarn add @szmarczak/http-timer`
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
**Note:**
|
||||||
|
> - The measured events resemble Node.js events, not the kernel ones.
|
||||||
|
> - Sending a chunk greater than [`highWaterMark`](https://nodejs.org/api/stream.html#stream_new_stream_writable_options) will result in invalid `upload` and `response` timings. You can avoid this by splitting the payload into smaller chunks.
|
||||||
|
|
||||||
|
```js
|
||||||
|
const https = require('https');
|
||||||
|
const timer = require('@szmarczak/http-timer');
|
||||||
|
|
||||||
|
const request = https.get('https://httpbin.org/anything');
|
||||||
|
timer(request);
|
||||||
|
|
||||||
|
request.once('response', response => {
|
||||||
|
response.resume();
|
||||||
|
response.once('end', () => {
|
||||||
|
console.log(response.timings); // You can use `request.timings` as well
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
// {
|
||||||
|
// start: 1572712180361,
|
||||||
|
// socket: 1572712180362,
|
||||||
|
// lookup: 1572712180415,
|
||||||
|
// connect: 1572712180571,
|
||||||
|
// upload: 1572712180884,
|
||||||
|
// response: 1572712181037,
|
||||||
|
// end: 1572712181039,
|
||||||
|
// error: undefined,
|
||||||
|
// abort: undefined,
|
||||||
|
// phases: {
|
||||||
|
// wait: 1,
|
||||||
|
// dns: 53,
|
||||||
|
// tcp: 156,
|
||||||
|
// request: 313,
|
||||||
|
// firstByte: 153,
|
||||||
|
// download: 2,
|
||||||
|
// total: 678
|
||||||
|
// }
|
||||||
|
// }
|
||||||
|
```
|
||||||
|
|
||||||
|
## API
|
||||||
|
|
||||||
|
### timer(request)
|
||||||
|
|
||||||
|
Returns: `Object`
|
||||||
|
|
||||||
|
**Note**: The time is a `number` representing the milliseconds elapsed since the UNIX epoch.
|
||||||
|
|
||||||
|
- `start` - Time when the request started.
|
||||||
|
- `socket` - Time when a socket was assigned to the request.
|
||||||
|
- `lookup` - Time when the DNS lookup finished.
|
||||||
|
- `connect` - Time when the socket successfully connected.
|
||||||
|
- `secureConnect` - Time when the socket securely connected.
|
||||||
|
- `upload` - Time when the request finished uploading.
|
||||||
|
- `response` - Time when the request fired `response` event.
|
||||||
|
- `end` - Time when the response fired `end` event.
|
||||||
|
- `error` - Time when the request fired `error` event.
|
||||||
|
- `abort` - Time when the request fired `abort` event.
|
||||||
|
- `phases`
|
||||||
|
- `wait` - `timings.socket - timings.start`
|
||||||
|
- `dns` - `timings.lookup - timings.socket`
|
||||||
|
- `tcp` - `timings.connect - timings.lookup`
|
||||||
|
- `tls` - `timings.secureConnect - timings.connect`
|
||||||
|
- `request` - `timings.upload - (timings.secureConnect || timings.connect)`
|
||||||
|
- `firstByte` - `timings.response - timings.upload`
|
||||||
|
- `download` - `timings.end - timings.response`
|
||||||
|
- `total` - `(timings.end || timings.error || timings.abort) - timings.start`
|
||||||
|
|
||||||
|
If something has not been measured yet, it will be `undefined`.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
MIT
|
||||||
+32
@@ -0,0 +1,32 @@
|
|||||||
|
/// <reference types="node" />
|
||||||
|
import { ClientRequest, IncomingMessage } from 'http';
|
||||||
|
export interface Timings {
|
||||||
|
start: number;
|
||||||
|
socket?: number;
|
||||||
|
lookup?: number;
|
||||||
|
connect?: number;
|
||||||
|
secureConnect?: number;
|
||||||
|
upload?: number;
|
||||||
|
response?: number;
|
||||||
|
end?: number;
|
||||||
|
error?: number;
|
||||||
|
abort?: number;
|
||||||
|
phases: {
|
||||||
|
wait?: number;
|
||||||
|
dns?: number;
|
||||||
|
tcp?: number;
|
||||||
|
tls?: number;
|
||||||
|
request?: number;
|
||||||
|
firstByte?: number;
|
||||||
|
download?: number;
|
||||||
|
total?: number;
|
||||||
|
};
|
||||||
|
}
|
||||||
|
export interface ClientRequestWithTimings extends ClientRequest {
|
||||||
|
timings?: Timings;
|
||||||
|
}
|
||||||
|
export interface IncomingMessageWithTimings extends IncomingMessage {
|
||||||
|
timings?: Timings;
|
||||||
|
}
|
||||||
|
declare const timer: (request: ClientRequestWithTimings) => Timings;
|
||||||
|
export default timer;
|
||||||
+126
@@ -0,0 +1,126 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
const defer_to_connect_1 = require("defer-to-connect");
|
||||||
|
const util_1 = require("util");
|
||||||
|
const nodejsMajorVersion = Number(process.versions.node.split('.')[0]);
|
||||||
|
const timer = (request) => {
|
||||||
|
if (request.timings) {
|
||||||
|
return request.timings;
|
||||||
|
}
|
||||||
|
const timings = {
|
||||||
|
start: Date.now(),
|
||||||
|
socket: undefined,
|
||||||
|
lookup: undefined,
|
||||||
|
connect: undefined,
|
||||||
|
secureConnect: undefined,
|
||||||
|
upload: undefined,
|
||||||
|
response: undefined,
|
||||||
|
end: undefined,
|
||||||
|
error: undefined,
|
||||||
|
abort: undefined,
|
||||||
|
phases: {
|
||||||
|
wait: undefined,
|
||||||
|
dns: undefined,
|
||||||
|
tcp: undefined,
|
||||||
|
tls: undefined,
|
||||||
|
request: undefined,
|
||||||
|
firstByte: undefined,
|
||||||
|
download: undefined,
|
||||||
|
total: undefined
|
||||||
|
}
|
||||||
|
};
|
||||||
|
request.timings = timings;
|
||||||
|
const handleError = (origin) => {
|
||||||
|
const emit = origin.emit.bind(origin);
|
||||||
|
origin.emit = (event, ...args) => {
|
||||||
|
// Catches the `error` event
|
||||||
|
if (event === 'error') {
|
||||||
|
timings.error = Date.now();
|
||||||
|
timings.phases.total = timings.error - timings.start;
|
||||||
|
origin.emit = emit;
|
||||||
|
}
|
||||||
|
// Saves the original behavior
|
||||||
|
return emit(event, ...args);
|
||||||
|
};
|
||||||
|
};
|
||||||
|
handleError(request);
|
||||||
|
const onAbort = () => {
|
||||||
|
timings.abort = Date.now();
|
||||||
|
// Let the `end` response event be responsible for setting the total phase,
|
||||||
|
// unless the Node.js major version is >= 13.
|
||||||
|
if (!timings.response || nodejsMajorVersion >= 13) {
|
||||||
|
timings.phases.total = Date.now() - timings.start;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
request.prependOnceListener('abort', onAbort);
|
||||||
|
const onSocket = (socket) => {
|
||||||
|
timings.socket = Date.now();
|
||||||
|
timings.phases.wait = timings.socket - timings.start;
|
||||||
|
if (util_1.types.isProxy(socket)) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
const lookupListener = () => {
|
||||||
|
timings.lookup = Date.now();
|
||||||
|
timings.phases.dns = timings.lookup - timings.socket;
|
||||||
|
};
|
||||||
|
socket.prependOnceListener('lookup', lookupListener);
|
||||||
|
defer_to_connect_1.default(socket, {
|
||||||
|
connect: () => {
|
||||||
|
timings.connect = Date.now();
|
||||||
|
if (timings.lookup === undefined) {
|
||||||
|
socket.removeListener('lookup', lookupListener);
|
||||||
|
timings.lookup = timings.connect;
|
||||||
|
timings.phases.dns = timings.lookup - timings.socket;
|
||||||
|
}
|
||||||
|
timings.phases.tcp = timings.connect - timings.lookup;
|
||||||
|
// This callback is called before flushing any data,
|
||||||
|
// so we don't need to set `timings.phases.request` here.
|
||||||
|
},
|
||||||
|
secureConnect: () => {
|
||||||
|
timings.secureConnect = Date.now();
|
||||||
|
timings.phases.tls = timings.secureConnect - timings.connect;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
};
|
||||||
|
if (request.socket) {
|
||||||
|
onSocket(request.socket);
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
request.prependOnceListener('socket', onSocket);
|
||||||
|
}
|
||||||
|
const onUpload = () => {
|
||||||
|
var _a;
|
||||||
|
timings.upload = Date.now();
|
||||||
|
timings.phases.request = timings.upload - ((_a = timings.secureConnect) !== null && _a !== void 0 ? _a : timings.connect);
|
||||||
|
};
|
||||||
|
const writableFinished = () => {
|
||||||
|
if (typeof request.writableFinished === 'boolean') {
|
||||||
|
return request.writableFinished;
|
||||||
|
}
|
||||||
|
// Node.js doesn't have `request.writableFinished` property
|
||||||
|
return request.finished && request.outputSize === 0 && (!request.socket || request.socket.writableLength === 0);
|
||||||
|
};
|
||||||
|
if (writableFinished()) {
|
||||||
|
onUpload();
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
request.prependOnceListener('finish', onUpload);
|
||||||
|
}
|
||||||
|
request.prependOnceListener('response', (response) => {
|
||||||
|
timings.response = Date.now();
|
||||||
|
timings.phases.firstByte = timings.response - timings.upload;
|
||||||
|
response.timings = timings;
|
||||||
|
handleError(response);
|
||||||
|
response.prependOnceListener('end', () => {
|
||||||
|
timings.end = Date.now();
|
||||||
|
timings.phases.download = timings.end - timings.response;
|
||||||
|
timings.phases.total = timings.end - timings.start;
|
||||||
|
});
|
||||||
|
response.prependOnceListener('aborted', onAbort);
|
||||||
|
});
|
||||||
|
return timings;
|
||||||
|
};
|
||||||
|
exports.default = timer;
|
||||||
|
// For CommonJS default export support
|
||||||
|
module.exports = timer;
|
||||||
|
module.exports.default = timer;
|
||||||
+72
@@ -0,0 +1,72 @@
|
|||||||
|
{
|
||||||
|
"name": "@szmarczak/http-timer",
|
||||||
|
"version": "4.0.6",
|
||||||
|
"description": "Timings for HTTP requests",
|
||||||
|
"main": "dist/source",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=10"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"test": "xo && tsc --noEmit && nyc ava",
|
||||||
|
"build": "del-cli dist && tsc",
|
||||||
|
"prepare": "npm run build",
|
||||||
|
"coveralls": "nyc report --reporter=text-lcov | coveralls"
|
||||||
|
},
|
||||||
|
"files": [
|
||||||
|
"dist/source"
|
||||||
|
],
|
||||||
|
"keywords": [
|
||||||
|
"http",
|
||||||
|
"https",
|
||||||
|
"timer",
|
||||||
|
"timings"
|
||||||
|
],
|
||||||
|
"repository": {
|
||||||
|
"type": "git",
|
||||||
|
"url": "git+https://github.com/szmarczak/http-timer.git"
|
||||||
|
},
|
||||||
|
"author": "Szymon Marczak",
|
||||||
|
"license": "MIT",
|
||||||
|
"bugs": {
|
||||||
|
"url": "https://github.com/szmarczak/http-timer/issues"
|
||||||
|
},
|
||||||
|
"homepage": "https://github.com/szmarczak/http-timer#readme",
|
||||||
|
"dependencies": {
|
||||||
|
"defer-to-connect": "^2.0.0"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@ava/typescript": "^2.0.0",
|
||||||
|
"@sindresorhus/tsconfig": "^1.0.2",
|
||||||
|
"@types/node": "^16.3.1",
|
||||||
|
"ava": "^3.15.0",
|
||||||
|
"coveralls": "^3.1.1",
|
||||||
|
"del-cli": "^3.0.1",
|
||||||
|
"http2-wrapper": "^2.0.7",
|
||||||
|
"nyc": "^15.1.0",
|
||||||
|
"p-event": "^4.2.0",
|
||||||
|
"typescript": "^4.3.5",
|
||||||
|
"xo": "^0.39.1"
|
||||||
|
},
|
||||||
|
"types": "dist/source",
|
||||||
|
"nyc": {
|
||||||
|
"extension": [
|
||||||
|
".ts"
|
||||||
|
],
|
||||||
|
"exclude": [
|
||||||
|
"**/tests/**"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"xo": {
|
||||||
|
"rules": {
|
||||||
|
"@typescript-eslint/no-non-null-assertion": "off"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"ava": {
|
||||||
|
"typescript": {
|
||||||
|
"compile": false,
|
||||||
|
"rewritePaths": {
|
||||||
|
"tests/": "dist/tests/"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
+21
@@ -0,0 +1,21 @@
|
|||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) Microsoft Corporation.
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user