Add local ADB web remote for Android TV
Node/Express server shells out to adb (connect/pair/keyevent/text/app launch) and serves a mobile-first installable PWA remote: power, mute, input switch, volume/channel rockers, D-pad, media transport, text entry, and one-tap streaming app launch. Supports multiple saved TVs and the Android 11+ wireless-debugging pairing flow. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RSVyYcrjrbmrMKT85G4fyn
This commit is contained in:
@@ -0,0 +1,4 @@
|
|||||||
|
node_modules/
|
||||||
|
data/devices.json
|
||||||
|
*.log
|
||||||
|
.DS_Store
|
||||||
@@ -0,0 +1,94 @@
|
|||||||
|
# TV ADB Remote
|
||||||
|
|
||||||
|
A slick, installable web remote for Android TV, controlled over ADB. Run a
|
||||||
|
small Node server on any always-on machine on your home network (a Pi, NAS,
|
||||||
|
old laptop, home server); point your phone's browser at it and control the
|
||||||
|
TV from a mobile-optimized PWA.
|
||||||
|
|
||||||
|
Why a local web app instead of a native Android app: Android TV only
|
||||||
|
exposes control over ADB once you enable network debugging, and the
|
||||||
|
official ADB tooling is a desktop program. Rather than reimplement the ADB
|
||||||
|
protocol inside a phone app, this runs `adb` on a machine that already has
|
||||||
|
it, and serves a touch-friendly remote UI to any phone/tablet browser on the
|
||||||
|
LAN. Add to the home screen and it behaves like an installed app.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- Power, mute, input switch, volume rocker, channel rocker
|
||||||
|
- D-pad navigation, OK, back, home, menu
|
||||||
|
- Media transport (rewind / play-pause / fast-forward)
|
||||||
|
- Text entry (e.g. search boxes) sent as real keystrokes
|
||||||
|
- One-tap launch for common streaming apps (Netflix, YouTube, Prime Video,
|
||||||
|
Disney+, Spotify, Plex)
|
||||||
|
- Manage multiple TVs, each remembered with a friendly name
|
||||||
|
- Built-in pairing flow for Android 11+ ("Wireless debugging")
|
||||||
|
- Installable PWA with offline app shell
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
- Node.js 18+ and `adb` (Android platform-tools) installed **on the machine
|
||||||
|
running the server** — not on the phone.
|
||||||
|
- macOS: `brew install android-platform-tools`
|
||||||
|
- Debian/Ubuntu: `sudo apt install android-tools-adb` (or
|
||||||
|
`android-sdk-platform-tools`)
|
||||||
|
- Windows: download "SDK Platform-Tools" from developer.android.com and
|
||||||
|
put `adb.exe` on PATH
|
||||||
|
- The TV and this server on the same local network.
|
||||||
|
|
||||||
|
## Set up the TV
|
||||||
|
|
||||||
|
1. On the Android TV: Settings → System (or Device Preferences) → About →
|
||||||
|
tap "Build" repeatedly to enable Developer options.
|
||||||
|
2. Settings → Developer options → turn on **Network debugging** (older
|
||||||
|
Android TV) or **Settings → System → Developer options → Wireless
|
||||||
|
debugging** (Android 11+ / Google TV).
|
||||||
|
3. Note the IP address shown (Settings → Network & Internet).
|
||||||
|
- Android TV ≤ 10: that's it — the debug port (5555) is open.
|
||||||
|
- Android 11+ / Google TV: it shows a separate pairing IP:port and a
|
||||||
|
6-digit code. Use the app's "Pair a new Android 11+ TV" flow, then add
|
||||||
|
the TV using its regular IP (still port 5555 once paired).
|
||||||
|
|
||||||
|
## Run the server
|
||||||
|
|
||||||
|
```sh
|
||||||
|
cd server
|
||||||
|
npm install
|
||||||
|
npm start
|
||||||
|
```
|
||||||
|
|
||||||
|
This serves the app at `http://<this-machine's-LAN-IP>:8787`. Open that URL
|
||||||
|
on your phone, add your TV by IP in Settings (⚙), then optionally "Add to
|
||||||
|
Home Screen" for a full-screen, app-like remote.
|
||||||
|
|
||||||
|
Override the port with `PORT=9000 npm start`, or point at a non-default
|
||||||
|
`adb` binary with `ADB_BIN=/path/to/adb npm start`.
|
||||||
|
|
||||||
|
## Development
|
||||||
|
|
||||||
|
```sh
|
||||||
|
cd server
|
||||||
|
npm test
|
||||||
|
```
|
||||||
|
|
||||||
|
Runs the server's unit tests (command construction, input validation,
|
||||||
|
device persistence) using Node's built-in test runner — no real TV
|
||||||
|
required.
|
||||||
|
|
||||||
|
## Project layout
|
||||||
|
|
||||||
|
```
|
||||||
|
server/ Express app + ADB bridge (source of truth for control logic)
|
||||||
|
src/adb.js Thin wrapper around the `adb` CLI (connect/pair/keyevent/…)
|
||||||
|
src/keycodes.js Android KeyEvent constants used by the remote buttons
|
||||||
|
src/deviceStore.js Persists saved TVs to data/devices.json
|
||||||
|
src/index.js HTTP API + static file serving
|
||||||
|
test/ Node test runner specs
|
||||||
|
public/ The PWA served to phones (HTML/CSS/vanilla JS, no build step)
|
||||||
|
scripts/ One-off dev scripts (icon generation)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Security note
|
||||||
|
|
||||||
|
This server has no authentication and will happily run `adb` commands
|
||||||
|
against whatever IP you give it — it's designed to sit on your trusted home
|
||||||
|
LAN, not the public internet. Don't port-forward it.
|
||||||
+263
@@ -0,0 +1,263 @@
|
|||||||
|
const APPS = [
|
||||||
|
{ name: "Netflix", package: "com.netflix.ninja" },
|
||||||
|
{ name: "YouTube", package: "com.google.android.youtube.tv" },
|
||||||
|
{ name: "Prime Video", package: "com.amazon.amazonvideo.livingroom" },
|
||||||
|
{ name: "Disney+", package: "com.disney.disneyplus" },
|
||||||
|
{ name: "Spotify", package: "com.spotify.tv.android" },
|
||||||
|
{ name: "Plex", package: "com.plexapp.android" },
|
||||||
|
];
|
||||||
|
|
||||||
|
const state = {
|
||||||
|
devices: [],
|
||||||
|
selectedId: localStorage.getItem("selectedDeviceId") || null,
|
||||||
|
};
|
||||||
|
|
||||||
|
const els = {
|
||||||
|
deviceSelect: document.getElementById("deviceSelect"),
|
||||||
|
statusDot: document.getElementById("statusDot"),
|
||||||
|
settingsBtn: document.getElementById("settingsBtn"),
|
||||||
|
settingsDialog: document.getElementById("settingsDialog"),
|
||||||
|
closeSettings: document.getElementById("closeSettings"),
|
||||||
|
deviceList: document.getElementById("deviceList"),
|
||||||
|
addDeviceForm: document.getElementById("addDeviceForm"),
|
||||||
|
newDeviceName: document.getElementById("newDeviceName"),
|
||||||
|
newDeviceHost: document.getElementById("newDeviceHost"),
|
||||||
|
pairForm: document.getElementById("pairForm"),
|
||||||
|
pairHost: document.getElementById("pairHost"),
|
||||||
|
pairCode: document.getElementById("pairCode"),
|
||||||
|
settingsMessage: document.getElementById("settingsMessage"),
|
||||||
|
searchForm: document.getElementById("searchForm"),
|
||||||
|
searchInput: document.getElementById("searchInput"),
|
||||||
|
appsRow: document.getElementById("appsRow"),
|
||||||
|
toast: document.getElementById("toast"),
|
||||||
|
};
|
||||||
|
|
||||||
|
function setSettingsMessage(text, isError = false) {
|
||||||
|
els.settingsMessage.textContent = text;
|
||||||
|
els.settingsMessage.classList.toggle("error", isError);
|
||||||
|
}
|
||||||
|
|
||||||
|
function showToast(message) {
|
||||||
|
els.toast.textContent = message;
|
||||||
|
els.toast.classList.add("show");
|
||||||
|
clearTimeout(showToast._t);
|
||||||
|
showToast._t = setTimeout(() => els.toast.classList.remove("show"), 1800);
|
||||||
|
}
|
||||||
|
|
||||||
|
function vibrate() {
|
||||||
|
if (navigator.vibrate) navigator.vibrate(12);
|
||||||
|
}
|
||||||
|
|
||||||
|
async function api(path, options) {
|
||||||
|
const res = await fetch(`/api${path}`, {
|
||||||
|
headers: { "Content-Type": "application/json" },
|
||||||
|
...options,
|
||||||
|
});
|
||||||
|
const body = await res.json().catch(() => ({}));
|
||||||
|
if (!res.ok) {
|
||||||
|
throw new Error(body.error || `Request failed (${res.status})`);
|
||||||
|
}
|
||||||
|
return body;
|
||||||
|
}
|
||||||
|
|
||||||
|
function currentDevice() {
|
||||||
|
return state.devices.find((d) => d.id === state.selectedId) || null;
|
||||||
|
}
|
||||||
|
|
||||||
|
function renderDeviceSelect() {
|
||||||
|
els.deviceSelect.innerHTML = "";
|
||||||
|
if (!state.devices.length) {
|
||||||
|
const opt = document.createElement("option");
|
||||||
|
opt.textContent = "No TVs added — tap ⚙";
|
||||||
|
els.deviceSelect.appendChild(opt);
|
||||||
|
els.statusDot.className = "status-dot";
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
for (const d of state.devices) {
|
||||||
|
const opt = document.createElement("option");
|
||||||
|
opt.value = d.id;
|
||||||
|
opt.textContent = d.name;
|
||||||
|
els.deviceSelect.appendChild(opt);
|
||||||
|
}
|
||||||
|
if (!state.selectedId || !state.devices.some((d) => d.id === state.selectedId)) {
|
||||||
|
state.selectedId = state.devices[0].id;
|
||||||
|
}
|
||||||
|
els.deviceSelect.value = state.selectedId;
|
||||||
|
localStorage.setItem("selectedDeviceId", state.selectedId);
|
||||||
|
updateStatusDot();
|
||||||
|
}
|
||||||
|
|
||||||
|
function updateStatusDot() {
|
||||||
|
const device = currentDevice();
|
||||||
|
els.statusDot.className = "status-dot";
|
||||||
|
if (device?.status === "device") els.statusDot.classList.add("online");
|
||||||
|
else if (device) els.statusDot.classList.add("offline");
|
||||||
|
}
|
||||||
|
|
||||||
|
function renderDeviceList() {
|
||||||
|
els.deviceList.innerHTML = "";
|
||||||
|
for (const d of state.devices) {
|
||||||
|
const li = document.createElement("li");
|
||||||
|
li.innerHTML = `
|
||||||
|
<div>
|
||||||
|
<div class="device-name">${escapeHtml(d.name)}</div>
|
||||||
|
<div class="device-host">${escapeHtml(d.host)} · ${d.status || "unknown"}</div>
|
||||||
|
</div>
|
||||||
|
<div class="device-actions">
|
||||||
|
<button data-action="connect" data-id="${d.id}">Connect</button>
|
||||||
|
<button class="danger" data-action="remove" data-id="${d.id}">Remove</button>
|
||||||
|
</div>
|
||||||
|
`;
|
||||||
|
els.deviceList.appendChild(li);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function escapeHtml(str) {
|
||||||
|
return String(str).replace(/[&<>"']/g, (c) => ({ "&": "&", "<": "<", ">": ">", '"': """, "'": "'" }[c]));
|
||||||
|
}
|
||||||
|
|
||||||
|
async function refreshDevices() {
|
||||||
|
const { devices } = await api("/devices");
|
||||||
|
state.devices = devices;
|
||||||
|
renderDeviceSelect();
|
||||||
|
renderDeviceList();
|
||||||
|
}
|
||||||
|
|
||||||
|
async function sendKey(key) {
|
||||||
|
const device = currentDevice();
|
||||||
|
if (!device) return showToast("Add a TV first (⚙)");
|
||||||
|
vibrate();
|
||||||
|
try {
|
||||||
|
await api(`/devices/${device.id}/key`, { method: "POST", body: JSON.stringify({ key }) });
|
||||||
|
} catch (err) {
|
||||||
|
showToast(err.message);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function launchApp(packageName, label) {
|
||||||
|
const device = currentDevice();
|
||||||
|
if (!device) return showToast("Add a TV first (⚙)");
|
||||||
|
vibrate();
|
||||||
|
try {
|
||||||
|
await api(`/devices/${device.id}/app`, { method: "POST", body: JSON.stringify({ package: packageName }) });
|
||||||
|
showToast(`Opening ${label}…`);
|
||||||
|
} catch (err) {
|
||||||
|
showToast(err.message);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function renderApps() {
|
||||||
|
els.appsRow.innerHTML = "";
|
||||||
|
for (const app of APPS) {
|
||||||
|
const btn = document.createElement("button");
|
||||||
|
btn.className = "btn";
|
||||||
|
btn.textContent = app.name;
|
||||||
|
btn.addEventListener("click", () => launchApp(app.package, app.name));
|
||||||
|
els.appsRow.appendChild(btn);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
document.querySelectorAll("[data-key]").forEach((btn) => {
|
||||||
|
btn.addEventListener("click", () => sendKey(btn.dataset.key));
|
||||||
|
});
|
||||||
|
|
||||||
|
document.querySelector('[data-action="mute"]').addEventListener("click", () => sendKey("VOLUME_MUTE"));
|
||||||
|
|
||||||
|
els.deviceSelect.addEventListener("change", () => {
|
||||||
|
state.selectedId = els.deviceSelect.value;
|
||||||
|
localStorage.setItem("selectedDeviceId", state.selectedId);
|
||||||
|
updateStatusDot();
|
||||||
|
});
|
||||||
|
|
||||||
|
els.settingsBtn.addEventListener("click", async () => {
|
||||||
|
setSettingsMessage("");
|
||||||
|
await refreshDevices().catch((err) => showToast(err.message));
|
||||||
|
els.settingsDialog.showModal();
|
||||||
|
});
|
||||||
|
|
||||||
|
els.closeSettings.addEventListener("click", () => els.settingsDialog.close());
|
||||||
|
|
||||||
|
els.addDeviceForm.addEventListener("submit", async (e) => {
|
||||||
|
e.preventDefault();
|
||||||
|
setSettingsMessage("");
|
||||||
|
try {
|
||||||
|
const { device } = await api("/devices", {
|
||||||
|
method: "POST",
|
||||||
|
body: JSON.stringify({ name: els.newDeviceName.value.trim(), host: els.newDeviceHost.value.trim() }),
|
||||||
|
});
|
||||||
|
els.newDeviceName.value = "";
|
||||||
|
els.newDeviceHost.value = "";
|
||||||
|
state.selectedId = device.id;
|
||||||
|
await refreshDevices();
|
||||||
|
setSettingsMessage(`Added ${device.name}. Connecting…`);
|
||||||
|
await api(`/devices/${device.id}/connect`, { method: "POST" });
|
||||||
|
setSettingsMessage(`Connected to ${device.name}.`);
|
||||||
|
await refreshDevices();
|
||||||
|
} catch (err) {
|
||||||
|
setSettingsMessage(err.message, true);
|
||||||
|
await refreshDevices();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
els.deviceList.addEventListener("click", async (e) => {
|
||||||
|
const target = e.target.closest("button");
|
||||||
|
if (!target) return;
|
||||||
|
const { action, id } = target.dataset;
|
||||||
|
setSettingsMessage("");
|
||||||
|
try {
|
||||||
|
if (action === "connect") {
|
||||||
|
setSettingsMessage("Connecting…");
|
||||||
|
await api(`/devices/${id}/connect`, { method: "POST" });
|
||||||
|
setSettingsMessage("Connected.");
|
||||||
|
} else if (action === "remove") {
|
||||||
|
await api(`/devices/${id}`, { method: "DELETE" });
|
||||||
|
}
|
||||||
|
await refreshDevices();
|
||||||
|
} catch (err) {
|
||||||
|
setSettingsMessage(err.message, true);
|
||||||
|
await refreshDevices();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
els.pairForm.addEventListener("submit", async (e) => {
|
||||||
|
e.preventDefault();
|
||||||
|
setSettingsMessage("Pairing…");
|
||||||
|
try {
|
||||||
|
const device = currentDevice();
|
||||||
|
if (!device) throw new Error("Add the TV's IP first, then pair.");
|
||||||
|
await api(`/devices/${device.id}/pair`, {
|
||||||
|
method: "POST",
|
||||||
|
body: JSON.stringify({ pairHost: els.pairHost.value.trim(), code: els.pairCode.value.trim() }),
|
||||||
|
});
|
||||||
|
setSettingsMessage("Paired! Reconnecting…");
|
||||||
|
els.pairHost.value = "";
|
||||||
|
els.pairCode.value = "";
|
||||||
|
await refreshDevices();
|
||||||
|
} catch (err) {
|
||||||
|
setSettingsMessage(err.message, true);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
els.searchForm.addEventListener("submit", async (e) => {
|
||||||
|
e.preventDefault();
|
||||||
|
const device = currentDevice();
|
||||||
|
const text = els.searchInput.value.trim();
|
||||||
|
if (!device || !text) return;
|
||||||
|
try {
|
||||||
|
await api(`/devices/${device.id}/text`, { method: "POST", body: JSON.stringify({ text }) });
|
||||||
|
els.searchInput.value = "";
|
||||||
|
showToast("Sent");
|
||||||
|
} catch (err) {
|
||||||
|
showToast(err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
renderApps();
|
||||||
|
refreshDevices().catch((err) => showToast(err.message));
|
||||||
|
setInterval(() => refreshDevices().catch(() => {}), 8000);
|
||||||
|
|
||||||
|
if ("serviceWorker" in navigator) {
|
||||||
|
window.addEventListener("load", () => {
|
||||||
|
navigator.serviceWorker.register("/sw.js").catch(() => {});
|
||||||
|
});
|
||||||
|
}
|
||||||
Binary file not shown.
|
After Width: | Height: | Size: 1.0 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 5.9 KiB |
@@ -0,0 +1,101 @@
|
|||||||
|
<!doctype html>
|
||||||
|
<html lang="en">
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8" />
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover, user-scalable=no" />
|
||||||
|
<title>TV Remote</title>
|
||||||
|
<meta name="theme-color" content="#0b0d12" />
|
||||||
|
<link rel="manifest" href="/manifest.json" />
|
||||||
|
<link rel="icon" href="/icons/icon-192.png" />
|
||||||
|
<link rel="apple-touch-icon" href="/icons/icon-192.png" />
|
||||||
|
<meta name="apple-mobile-web-app-capable" content="yes" />
|
||||||
|
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
|
||||||
|
<link rel="stylesheet" href="/styles.css" />
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<header class="topbar">
|
||||||
|
<div class="device-picker">
|
||||||
|
<select id="deviceSelect" aria-label="Select TV"></select>
|
||||||
|
<span id="statusDot" class="status-dot" title="Connection status"></span>
|
||||||
|
</div>
|
||||||
|
<button id="settingsBtn" class="icon-btn" aria-label="Settings">⚙</button>
|
||||||
|
</header>
|
||||||
|
|
||||||
|
<main id="remote" class="remote">
|
||||||
|
<div class="row row-top">
|
||||||
|
<button class="btn btn-round" data-key="POWER" aria-label="Power">⏻</button>
|
||||||
|
<button class="btn btn-round" data-key="TV_INPUT" aria-label="Input">⇄</button>
|
||||||
|
<button class="btn btn-round" data-action="mute" aria-label="Mute">🔇</button>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="dpad">
|
||||||
|
<button class="btn dpad-up" data-key="DPAD_UP" aria-label="Up">▲</button>
|
||||||
|
<button class="btn dpad-left" data-key="DPAD_LEFT" aria-label="Left">◀</button>
|
||||||
|
<button class="btn dpad-center" data-key="DPAD_CENTER" aria-label="OK">OK</button>
|
||||||
|
<button class="btn dpad-right" data-key="DPAD_RIGHT" aria-label="Right">▶</button>
|
||||||
|
<button class="btn dpad-down" data-key="DPAD_DOWN" aria-label="Down">▼</button>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="row row-nav">
|
||||||
|
<button class="btn" data-key="BACK" aria-label="Back">⤺ Back</button>
|
||||||
|
<button class="btn" data-key="HOME" aria-label="Home">⌂ Home</button>
|
||||||
|
<button class="btn" data-key="MENU" aria-label="Menu">☰ Menu</button>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="row row-vol-ch">
|
||||||
|
<div class="rocker" data-rocker="volume">
|
||||||
|
<span class="rocker-label">VOL</span>
|
||||||
|
<button class="btn rocker-btn" data-key="VOLUME_UP" aria-label="Volume up">+</button>
|
||||||
|
<button class="btn rocker-btn" data-key="VOLUME_DOWN" aria-label="Volume down">−</button>
|
||||||
|
</div>
|
||||||
|
<div class="rocker" data-rocker="channel">
|
||||||
|
<span class="rocker-label">CH</span>
|
||||||
|
<button class="btn rocker-btn" data-key="CHANNEL_UP" aria-label="Channel up">+</button>
|
||||||
|
<button class="btn rocker-btn" data-key="CHANNEL_DOWN" aria-label="Channel down">−</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="row row-media">
|
||||||
|
<button class="btn" data-key="MEDIA_REWIND" aria-label="Rewind">⏪</button>
|
||||||
|
<button class="btn" data-key="MEDIA_PLAY_PAUSE" aria-label="Play/Pause">⏯</button>
|
||||||
|
<button class="btn" data-key="MEDIA_FAST_FORWARD" aria-label="Fast forward">⏩</button>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<form class="row row-search" id="searchForm">
|
||||||
|
<input id="searchInput" type="text" inputmode="text" placeholder="Type to search…" autocomplete="off" />
|
||||||
|
<button type="submit" class="btn">Send</button>
|
||||||
|
</form>
|
||||||
|
|
||||||
|
<div class="apps" id="appsRow"></div>
|
||||||
|
</main>
|
||||||
|
|
||||||
|
<dialog id="settingsDialog">
|
||||||
|
<h2>TVs</h2>
|
||||||
|
<ul id="deviceList" class="device-list"></ul>
|
||||||
|
|
||||||
|
<form id="addDeviceForm" class="add-device-form">
|
||||||
|
<input id="newDeviceName" type="text" placeholder="Name (e.g. Living Room)" autocomplete="off" />
|
||||||
|
<input id="newDeviceHost" type="text" placeholder="IP address (e.g. 192.168.1.50)" autocomplete="off" required />
|
||||||
|
<button type="submit" class="btn">Add TV</button>
|
||||||
|
</form>
|
||||||
|
|
||||||
|
<details class="pair-details">
|
||||||
|
<summary>Pair a new Android 11+ TV</summary>
|
||||||
|
<form id="pairForm" class="pair-form">
|
||||||
|
<p>On the TV: Settings → System → Developer options → Wireless debugging → Pair device with pairing code.</p>
|
||||||
|
<input id="pairHost" type="text" placeholder="Pairing IP:port (e.g. 192.168.1.50:41231)" autocomplete="off" required />
|
||||||
|
<input id="pairCode" type="text" inputmode="numeric" placeholder="6-digit code" autocomplete="off" required />
|
||||||
|
<button type="submit" class="btn">Pair</button>
|
||||||
|
</form>
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<p id="settingsMessage" class="settings-message" role="status"></p>
|
||||||
|
|
||||||
|
<button id="closeSettings" class="btn btn-close">Close</button>
|
||||||
|
</dialog>
|
||||||
|
|
||||||
|
<div id="toast" class="toast" role="status" aria-live="polite"></div>
|
||||||
|
|
||||||
|
<script src="/app.js"></script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
{
|
||||||
|
"name": "TV Remote",
|
||||||
|
"short_name": "TV Remote",
|
||||||
|
"description": "ADB-powered remote control for Android TV",
|
||||||
|
"start_url": "/",
|
||||||
|
"display": "standalone",
|
||||||
|
"background_color": "#0b0d12",
|
||||||
|
"theme_color": "#0b0d12",
|
||||||
|
"orientation": "portrait",
|
||||||
|
"icons": [
|
||||||
|
{ "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png", "purpose": "any maskable" },
|
||||||
|
{ "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "any maskable" }
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,356 @@
|
|||||||
|
:root {
|
||||||
|
--bg: #0b0d12;
|
||||||
|
--surface: #161a23;
|
||||||
|
--surface-raised: #1e2430;
|
||||||
|
--accent: #58d68d;
|
||||||
|
--accent-dim: #2e3a4a;
|
||||||
|
--text: #eef1f6;
|
||||||
|
--text-dim: #8a93a3;
|
||||||
|
--danger: #e0605a;
|
||||||
|
--radius: 20px;
|
||||||
|
color-scheme: dark;
|
||||||
|
}
|
||||||
|
|
||||||
|
* {
|
||||||
|
box-sizing: border-box;
|
||||||
|
-webkit-tap-highlight-color: transparent;
|
||||||
|
}
|
||||||
|
|
||||||
|
html, body {
|
||||||
|
height: 100%;
|
||||||
|
}
|
||||||
|
|
||||||
|
body {
|
||||||
|
margin: 0;
|
||||||
|
background: var(--bg);
|
||||||
|
color: var(--text);
|
||||||
|
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
min-height: 100dvh;
|
||||||
|
overscroll-behavior: none;
|
||||||
|
user-select: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.topbar {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: space-between;
|
||||||
|
padding: calc(env(safe-area-inset-top, 0px) + 12px) 16px 8px;
|
||||||
|
gap: 8px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.device-picker {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: 8px;
|
||||||
|
flex: 1;
|
||||||
|
min-width: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
#deviceSelect {
|
||||||
|
flex: 1;
|
||||||
|
min-width: 0;
|
||||||
|
background: var(--surface);
|
||||||
|
color: var(--text);
|
||||||
|
border: none;
|
||||||
|
border-radius: 12px;
|
||||||
|
padding: 10px 12px;
|
||||||
|
font-size: 15px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.status-dot {
|
||||||
|
width: 10px;
|
||||||
|
height: 10px;
|
||||||
|
border-radius: 50%;
|
||||||
|
background: var(--text-dim);
|
||||||
|
flex-shrink: 0;
|
||||||
|
}
|
||||||
|
.status-dot.online { background: var(--accent); }
|
||||||
|
.status-dot.offline { background: var(--danger); }
|
||||||
|
|
||||||
|
.icon-btn {
|
||||||
|
background: var(--surface);
|
||||||
|
border: none;
|
||||||
|
color: var(--text);
|
||||||
|
font-size: 18px;
|
||||||
|
width: 42px;
|
||||||
|
height: 42px;
|
||||||
|
border-radius: 12px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.remote {
|
||||||
|
flex: 1;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: 18px;
|
||||||
|
padding: 8px 20px calc(env(safe-area-inset-bottom, 0px) + 24px);
|
||||||
|
max-width: 420px;
|
||||||
|
width: 100%;
|
||||||
|
margin: 0 auto;
|
||||||
|
}
|
||||||
|
|
||||||
|
.btn {
|
||||||
|
background: var(--surface);
|
||||||
|
color: var(--text);
|
||||||
|
border: none;
|
||||||
|
border-radius: 16px;
|
||||||
|
font-size: 16px;
|
||||||
|
padding: 14px 10px;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
gap: 6px;
|
||||||
|
transition: background 80ms ease, transform 80ms ease;
|
||||||
|
}
|
||||||
|
|
||||||
|
.btn:active {
|
||||||
|
background: var(--surface-raised);
|
||||||
|
transform: scale(0.96);
|
||||||
|
}
|
||||||
|
|
||||||
|
.row {
|
||||||
|
display: flex;
|
||||||
|
gap: 12px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.row-top .btn-round {
|
||||||
|
flex: 1;
|
||||||
|
aspect-ratio: 1;
|
||||||
|
border-radius: 50%;
|
||||||
|
font-size: 22px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.row-top .btn-round[data-key="POWER"] {
|
||||||
|
color: var(--danger);
|
||||||
|
}
|
||||||
|
|
||||||
|
.dpad {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: 1fr 1fr 1fr;
|
||||||
|
grid-template-rows: 1fr 1fr 1fr;
|
||||||
|
gap: 6px;
|
||||||
|
aspect-ratio: 1;
|
||||||
|
max-width: 280px;
|
||||||
|
margin: 0 auto;
|
||||||
|
width: 100%;
|
||||||
|
}
|
||||||
|
|
||||||
|
.dpad-up { grid-area: 1 / 2 / 2 / 3; border-radius: 20px 20px 6px 6px; }
|
||||||
|
.dpad-left { grid-area: 2 / 1 / 3 / 2; border-radius: 20px 6px 6px 20px; }
|
||||||
|
.dpad-center {
|
||||||
|
grid-area: 2 / 2 / 3 / 3;
|
||||||
|
border-radius: 50%;
|
||||||
|
background: var(--accent-dim);
|
||||||
|
font-weight: 600;
|
||||||
|
letter-spacing: 0.05em;
|
||||||
|
}
|
||||||
|
.dpad-right { grid-area: 2 / 3 / 3 / 4; border-radius: 6px 20px 20px 6px; }
|
||||||
|
.dpad-down { grid-area: 3 / 2 / 4 / 3; border-radius: 6px 6px 20px 20px; }
|
||||||
|
|
||||||
|
.row-nav .btn {
|
||||||
|
flex: 1;
|
||||||
|
font-size: 14px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.row-vol-ch {
|
||||||
|
gap: 16px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.rocker {
|
||||||
|
flex: 1;
|
||||||
|
background: var(--surface);
|
||||||
|
border-radius: 20px;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
align-items: center;
|
||||||
|
overflow: hidden;
|
||||||
|
}
|
||||||
|
|
||||||
|
.rocker-label {
|
||||||
|
font-size: 11px;
|
||||||
|
letter-spacing: 0.1em;
|
||||||
|
color: var(--text-dim);
|
||||||
|
padding-top: 10px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.rocker-btn {
|
||||||
|
width: 100%;
|
||||||
|
background: transparent;
|
||||||
|
border-radius: 0;
|
||||||
|
font-size: 22px;
|
||||||
|
padding: 14px 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.rocker-btn:active {
|
||||||
|
background: var(--surface-raised);
|
||||||
|
}
|
||||||
|
|
||||||
|
.row-media .btn {
|
||||||
|
flex: 1;
|
||||||
|
font-size: 18px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.row-search {
|
||||||
|
gap: 10px;
|
||||||
|
}
|
||||||
|
|
||||||
|
#searchInput {
|
||||||
|
flex: 1;
|
||||||
|
min-width: 0;
|
||||||
|
background: var(--surface);
|
||||||
|
color: var(--text);
|
||||||
|
border: none;
|
||||||
|
border-radius: 16px;
|
||||||
|
padding: 14px 16px;
|
||||||
|
font-size: 16px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.row-search .btn {
|
||||||
|
flex: 0 0 auto;
|
||||||
|
padding: 14px 18px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.apps {
|
||||||
|
display: flex;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
gap: 10px;
|
||||||
|
justify-content: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
.apps .btn {
|
||||||
|
flex: 1 1 calc(33% - 10px);
|
||||||
|
font-size: 13px;
|
||||||
|
padding: 12px 6px;
|
||||||
|
}
|
||||||
|
|
||||||
|
dialog {
|
||||||
|
border: none;
|
||||||
|
border-radius: var(--radius);
|
||||||
|
background: var(--surface);
|
||||||
|
color: var(--text);
|
||||||
|
width: min(420px, 92vw);
|
||||||
|
padding: 20px;
|
||||||
|
}
|
||||||
|
|
||||||
|
dialog::backdrop {
|
||||||
|
background: rgba(0, 0, 0, 0.6);
|
||||||
|
}
|
||||||
|
|
||||||
|
dialog h2 {
|
||||||
|
margin: 0 0 12px;
|
||||||
|
font-size: 18px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.device-list {
|
||||||
|
list-style: none;
|
||||||
|
margin: 0 0 16px;
|
||||||
|
padding: 0;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: 8px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.device-list li {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: space-between;
|
||||||
|
background: var(--surface-raised);
|
||||||
|
border-radius: 12px;
|
||||||
|
padding: 10px 12px;
|
||||||
|
gap: 8px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.device-list .device-name {
|
||||||
|
font-weight: 600;
|
||||||
|
font-size: 14px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.device-list .device-host {
|
||||||
|
font-size: 12px;
|
||||||
|
color: var(--text-dim);
|
||||||
|
}
|
||||||
|
|
||||||
|
.device-list .device-actions {
|
||||||
|
display: flex;
|
||||||
|
gap: 6px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.device-list button {
|
||||||
|
background: var(--accent-dim);
|
||||||
|
color: var(--text);
|
||||||
|
border: none;
|
||||||
|
border-radius: 8px;
|
||||||
|
padding: 8px 10px;
|
||||||
|
font-size: 12px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.device-list button.danger {
|
||||||
|
background: transparent;
|
||||||
|
color: var(--danger);
|
||||||
|
}
|
||||||
|
|
||||||
|
.add-device-form, .pair-form {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: 8px;
|
||||||
|
margin-top: 8px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.add-device-form input, .pair-form input {
|
||||||
|
background: var(--surface-raised);
|
||||||
|
border: none;
|
||||||
|
border-radius: 10px;
|
||||||
|
padding: 10px 12px;
|
||||||
|
color: var(--text);
|
||||||
|
font-size: 14px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.pair-details {
|
||||||
|
margin-top: 14px;
|
||||||
|
font-size: 13px;
|
||||||
|
color: var(--text-dim);
|
||||||
|
}
|
||||||
|
|
||||||
|
.pair-details p {
|
||||||
|
font-size: 12px;
|
||||||
|
line-height: 1.4;
|
||||||
|
}
|
||||||
|
|
||||||
|
.settings-message {
|
||||||
|
min-height: 18px;
|
||||||
|
font-size: 13px;
|
||||||
|
color: var(--accent);
|
||||||
|
}
|
||||||
|
|
||||||
|
.settings-message.error {
|
||||||
|
color: var(--danger);
|
||||||
|
}
|
||||||
|
|
||||||
|
.btn-close {
|
||||||
|
width: 100%;
|
||||||
|
margin-top: 8px;
|
||||||
|
background: var(--accent-dim);
|
||||||
|
}
|
||||||
|
|
||||||
|
.toast {
|
||||||
|
position: fixed;
|
||||||
|
left: 50%;
|
||||||
|
bottom: calc(env(safe-area-inset-bottom, 0px) + 20px);
|
||||||
|
transform: translateX(-50%) translateY(20px);
|
||||||
|
background: var(--surface-raised);
|
||||||
|
color: var(--text);
|
||||||
|
padding: 10px 16px;
|
||||||
|
border-radius: 12px;
|
||||||
|
font-size: 13px;
|
||||||
|
opacity: 0;
|
||||||
|
pointer-events: none;
|
||||||
|
transition: opacity 150ms ease, transform 150ms ease;
|
||||||
|
max-width: 85vw;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
.toast.show {
|
||||||
|
opacity: 1;
|
||||||
|
transform: translateX(-50%) translateY(0);
|
||||||
|
}
|
||||||
@@ -0,0 +1,25 @@
|
|||||||
|
const CACHE = "tv-remote-shell-v1";
|
||||||
|
const SHELL_FILES = ["/", "/styles.css", "/app.js", "/manifest.json"];
|
||||||
|
|
||||||
|
self.addEventListener("install", (event) => {
|
||||||
|
event.waitUntil(caches.open(CACHE).then((cache) => cache.addAll(SHELL_FILES)));
|
||||||
|
self.skipWaiting();
|
||||||
|
});
|
||||||
|
|
||||||
|
self.addEventListener("activate", (event) => {
|
||||||
|
event.waitUntil(
|
||||||
|
caches.keys().then((keys) => Promise.all(keys.filter((k) => k !== CACHE).map((k) => caches.delete(k))))
|
||||||
|
);
|
||||||
|
self.clients.claim();
|
||||||
|
});
|
||||||
|
|
||||||
|
// Network-first for API calls (never serve stale remote-control state),
|
||||||
|
// cache-first for the static shell so the app still opens offline.
|
||||||
|
self.addEventListener("fetch", (event) => {
|
||||||
|
const url = new URL(event.request.url);
|
||||||
|
if (url.pathname.startsWith("/api/")) return;
|
||||||
|
|
||||||
|
event.respondWith(
|
||||||
|
caches.match(event.request).then((cached) => cached || fetch(event.request))
|
||||||
|
);
|
||||||
|
});
|
||||||
@@ -0,0 +1,95 @@
|
|||||||
|
// One-off generator for the PWA app icons: a rounded remote-control glyph
|
||||||
|
// on a dark background. Pure Node (zlib + zlib.crc32), no image deps.
|
||||||
|
import { deflateSync, crc32 } from "node:zlib";
|
||||||
|
import { writeFileSync, mkdirSync } from "node:fs";
|
||||||
|
|
||||||
|
const BG = [11, 13, 18]; // #0b0d12
|
||||||
|
const FG = [88, 214, 141]; // accent green
|
||||||
|
const FG_DIM = [46, 58, 74];
|
||||||
|
|
||||||
|
function chunk(type, data) {
|
||||||
|
const typeBuf = Buffer.from(type, "ascii");
|
||||||
|
const len = Buffer.alloc(4);
|
||||||
|
len.writeUInt32BE(data.length, 0);
|
||||||
|
const crcInput = Buffer.concat([typeBuf, data]);
|
||||||
|
const crc = Buffer.alloc(4);
|
||||||
|
crc.writeUInt32BE(crc32(crcInput) >>> 0, 0);
|
||||||
|
return Buffer.concat([len, typeBuf, data, crc]);
|
||||||
|
}
|
||||||
|
|
||||||
|
function inRoundedRect(x, y, w, h, left, top, right, bottom, radius) {
|
||||||
|
if (x < left || x > right || y < top || y > bottom) return false;
|
||||||
|
const cx = x < left + radius ? left + radius : x > right - radius ? right - radius : x;
|
||||||
|
const cy = y < top + radius ? top + radius : y > bottom - radius ? bottom - radius : y;
|
||||||
|
const dx = x - cx;
|
||||||
|
const dy = y - cy;
|
||||||
|
return dx * dx + dy * dy <= radius * radius || (x >= left + radius && x <= right - radius) || (y >= top + radius && y <= bottom - radius);
|
||||||
|
}
|
||||||
|
|
||||||
|
function makeIcon(size) {
|
||||||
|
const margin = Math.round(size * 0.2);
|
||||||
|
const left = margin;
|
||||||
|
const right = size - margin;
|
||||||
|
const top = Math.round(size * 0.08);
|
||||||
|
const bottom = size - top;
|
||||||
|
const radius = Math.round(size * 0.14);
|
||||||
|
|
||||||
|
const btnRadius = Math.max(2, Math.round(size * 0.035));
|
||||||
|
const btnCenters = [
|
||||||
|
[size * 0.5, size * 0.28],
|
||||||
|
[size * 0.5, size * 0.46],
|
||||||
|
[size * 0.32, size * 0.62],
|
||||||
|
[size * 0.68, size * 0.62],
|
||||||
|
[size * 0.5, size * 0.78],
|
||||||
|
];
|
||||||
|
|
||||||
|
const raw = Buffer.alloc(size * (1 + size * 4));
|
||||||
|
for (let y = 0; y < size; y++) {
|
||||||
|
let rowStart = y * (1 + size * 4);
|
||||||
|
raw[rowStart] = 0; // filter type: none
|
||||||
|
for (let x = 0; x < size; x++) {
|
||||||
|
let [r, g, b] = BG;
|
||||||
|
if (inRoundedRect(x, y, size, size, left, top, right, bottom, radius)) {
|
||||||
|
[r, g, b] = FG_DIM;
|
||||||
|
for (const [bx, by] of btnCenters) {
|
||||||
|
const dx = x - bx;
|
||||||
|
const dy = y - by;
|
||||||
|
if (dx * dx + dy * dy <= btnRadius * btnRadius) {
|
||||||
|
[r, g, b] = FG;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const off = rowStart + 1 + x * 4;
|
||||||
|
raw[off] = r;
|
||||||
|
raw[off + 1] = g;
|
||||||
|
raw[off + 2] = b;
|
||||||
|
raw[off + 3] = 255;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const ihdr = Buffer.alloc(13);
|
||||||
|
ihdr.writeUInt32BE(size, 0);
|
||||||
|
ihdr.writeUInt32BE(size, 4);
|
||||||
|
ihdr[8] = 8; // bit depth
|
||||||
|
ihdr[9] = 6; // color type RGBA
|
||||||
|
ihdr[10] = 0;
|
||||||
|
ihdr[11] = 0;
|
||||||
|
ihdr[12] = 0;
|
||||||
|
|
||||||
|
const idat = deflateSync(raw);
|
||||||
|
const signature = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
|
||||||
|
return Buffer.concat([
|
||||||
|
signature,
|
||||||
|
chunk("IHDR", ihdr),
|
||||||
|
chunk("IDAT", idat),
|
||||||
|
chunk("IEND", Buffer.alloc(0)),
|
||||||
|
]);
|
||||||
|
}
|
||||||
|
|
||||||
|
mkdirSync(new URL("../public/icons", import.meta.url), { recursive: true });
|
||||||
|
for (const size of [192, 512]) {
|
||||||
|
const png = makeIcon(size);
|
||||||
|
writeFileSync(new URL(`../public/icons/icon-${size}.png`, import.meta.url), png);
|
||||||
|
console.log(`wrote icon-${size}.png (${png.length} bytes)`);
|
||||||
|
}
|
||||||
Generated
+835
@@ -0,0 +1,835 @@
|
|||||||
|
{
|
||||||
|
"name": "tv-adb-remote-server",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"lockfileVersion": 3,
|
||||||
|
"requires": true,
|
||||||
|
"packages": {
|
||||||
|
"": {
|
||||||
|
"name": "tv-adb-remote-server",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"dependencies": {
|
||||||
|
"express": "^4.19.2"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/accepts": {
|
||||||
|
"version": "1.3.8",
|
||||||
|
"resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz",
|
||||||
|
"integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"mime-types": "~2.1.34",
|
||||||
|
"negotiator": "0.6.3"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/array-flatten": {
|
||||||
|
"version": "1.1.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz",
|
||||||
|
"integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==",
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/body-parser": {
|
||||||
|
"version": "1.20.8",
|
||||||
|
"resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.8.tgz",
|
||||||
|
"integrity": "sha512-JNcyFQ64OiijEkPzUBTCe+hyPXUD/3LEldGQ6iF5LR1w00mx9o7xtDWHXBY2iItjdCFGoilOLNQbH943ut7pHA==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"bytes": "~3.1.2",
|
||||||
|
"content-type": "~1.0.5",
|
||||||
|
"debug": "2.6.9",
|
||||||
|
"depd": "2.0.0",
|
||||||
|
"destroy": "~1.2.0",
|
||||||
|
"http-errors": "~2.0.1",
|
||||||
|
"iconv-lite": "~0.4.24",
|
||||||
|
"on-finished": "~2.4.1",
|
||||||
|
"qs": "~6.16.0",
|
||||||
|
"raw-body": "~2.5.3",
|
||||||
|
"type-is": "~1.6.18",
|
||||||
|
"unpipe": "~1.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8",
|
||||||
|
"npm": "1.2.8000 || >= 1.4.16"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/bytes": {
|
||||||
|
"version": "3.1.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
|
||||||
|
"integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/call-bind-apply-helpers": {
|
||||||
|
"version": "1.0.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
|
||||||
|
"integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"es-errors": "^1.3.0",
|
||||||
|
"function-bind": "^1.1.2"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/call-bound": {
|
||||||
|
"version": "1.0.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
|
||||||
|
"integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"call-bind-apply-helpers": "^1.0.2",
|
||||||
|
"get-intrinsic": "^1.3.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/content-disposition": {
|
||||||
|
"version": "0.5.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz",
|
||||||
|
"integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"safe-buffer": "5.2.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/content-type": {
|
||||||
|
"version": "1.0.5",
|
||||||
|
"resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
|
||||||
|
"integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/cookie": {
|
||||||
|
"version": "0.7.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
|
||||||
|
"integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/cookie-signature": {
|
||||||
|
"version": "1.0.7",
|
||||||
|
"resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.7.tgz",
|
||||||
|
"integrity": "sha512-NXdYc3dLr47pBkpUCHtKSwIOQXLVn8dZEuywboCOJY/osA0wFSLlSawr3KN8qXJEyX66FcONTH8EIlVuK0yyFA==",
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/debug": {
|
||||||
|
"version": "2.6.9",
|
||||||
|
"resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
|
||||||
|
"integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"ms": "2.0.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/depd": {
|
||||||
|
"version": "2.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
|
||||||
|
"integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/destroy": {
|
||||||
|
"version": "1.2.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz",
|
||||||
|
"integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8",
|
||||||
|
"npm": "1.2.8000 || >= 1.4.16"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/dunder-proto": {
|
||||||
|
"version": "1.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
|
||||||
|
"integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"call-bind-apply-helpers": "^1.0.1",
|
||||||
|
"es-errors": "^1.3.0",
|
||||||
|
"gopd": "^1.2.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/ee-first": {
|
||||||
|
"version": "1.1.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
|
||||||
|
"integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/encodeurl": {
|
||||||
|
"version": "2.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
|
||||||
|
"integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"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==",
|
||||||
|
"license": "MIT",
|
||||||
|
"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==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/es-object-atoms": {
|
||||||
|
"version": "1.1.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.2.tgz",
|
||||||
|
"integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"es-errors": "^1.3.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/escape-html": {
|
||||||
|
"version": "1.0.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
|
||||||
|
"integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/etag": {
|
||||||
|
"version": "1.8.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
|
||||||
|
"integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/express": {
|
||||||
|
"version": "4.22.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/express/-/express-4.22.3.tgz",
|
||||||
|
"integrity": "sha512-Bdcs4+3qlpVlx2NRn6fgX2Ue2/gGRaPeawebgclM0ERSCqDpA+owF1fdPwjJUTAJWMTuAaxjDf+hzb0/4eKvvw==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"accepts": "~1.3.8",
|
||||||
|
"array-flatten": "1.1.1",
|
||||||
|
"body-parser": "~1.20.5",
|
||||||
|
"content-disposition": "~0.5.4",
|
||||||
|
"content-type": "~1.0.4",
|
||||||
|
"cookie": "~0.7.1",
|
||||||
|
"cookie-signature": "~1.0.6",
|
||||||
|
"debug": "2.6.9",
|
||||||
|
"depd": "2.0.0",
|
||||||
|
"encodeurl": "~2.0.0",
|
||||||
|
"escape-html": "~1.0.3",
|
||||||
|
"etag": "~1.8.1",
|
||||||
|
"finalhandler": "~1.3.1",
|
||||||
|
"fresh": "~0.5.2",
|
||||||
|
"http-errors": "~2.0.0",
|
||||||
|
"merge-descriptors": "1.0.3",
|
||||||
|
"methods": "~1.1.2",
|
||||||
|
"on-finished": "~2.4.1",
|
||||||
|
"parseurl": "~1.3.3",
|
||||||
|
"path-to-regexp": "~0.1.13",
|
||||||
|
"proxy-addr": "~2.0.7",
|
||||||
|
"qs": "~6.16.0",
|
||||||
|
"range-parser": "~1.2.1",
|
||||||
|
"safe-buffer": "5.2.1",
|
||||||
|
"send": "~0.19.0",
|
||||||
|
"serve-static": "~1.16.2",
|
||||||
|
"setprototypeof": "1.2.0",
|
||||||
|
"statuses": "~2.0.1",
|
||||||
|
"type-is": "~1.6.18",
|
||||||
|
"utils-merge": "1.0.1",
|
||||||
|
"vary": "~1.1.2"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.10.0"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"type": "opencollective",
|
||||||
|
"url": "https://opencollective.com/express"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/finalhandler": {
|
||||||
|
"version": "1.3.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.2.tgz",
|
||||||
|
"integrity": "sha512-aA4RyPcd3badbdABGDuTXCMTtOneUCAYH/gxoYRTZlIJdF0YPWuGqiAsIrhNnnqdXGswYk6dGujem4w80UJFhg==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"debug": "2.6.9",
|
||||||
|
"encodeurl": "~2.0.0",
|
||||||
|
"escape-html": "~1.0.3",
|
||||||
|
"on-finished": "~2.4.1",
|
||||||
|
"parseurl": "~1.3.3",
|
||||||
|
"statuses": "~2.0.2",
|
||||||
|
"unpipe": "~1.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/forwarded": {
|
||||||
|
"version": "0.2.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
|
||||||
|
"integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/fresh": {
|
||||||
|
"version": "0.5.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz",
|
||||||
|
"integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/function-bind": {
|
||||||
|
"version": "1.1.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
|
||||||
|
"integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
|
||||||
|
"license": "MIT",
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/get-intrinsic": {
|
||||||
|
"version": "1.3.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
|
||||||
|
"integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"call-bind-apply-helpers": "^1.0.2",
|
||||||
|
"es-define-property": "^1.0.1",
|
||||||
|
"es-errors": "^1.3.0",
|
||||||
|
"es-object-atoms": "^1.1.1",
|
||||||
|
"function-bind": "^1.1.2",
|
||||||
|
"get-proto": "^1.0.1",
|
||||||
|
"gopd": "^1.2.0",
|
||||||
|
"has-symbols": "^1.1.0",
|
||||||
|
"hasown": "^2.0.2",
|
||||||
|
"math-intrinsics": "^1.1.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/get-proto": {
|
||||||
|
"version": "1.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
|
||||||
|
"integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"dunder-proto": "^1.0.1",
|
||||||
|
"es-object-atoms": "^1.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/gopd": {
|
||||||
|
"version": "1.2.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
|
||||||
|
"integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/has-symbols": {
|
||||||
|
"version": "1.1.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
|
||||||
|
"integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/hasown": {
|
||||||
|
"version": "2.0.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.4.tgz",
|
||||||
|
"integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"function-bind": "^1.1.2"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/http-errors": {
|
||||||
|
"version": "2.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
|
||||||
|
"integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"depd": "~2.0.0",
|
||||||
|
"inherits": "~2.0.4",
|
||||||
|
"setprototypeof": "~1.2.0",
|
||||||
|
"statuses": "~2.0.2",
|
||||||
|
"toidentifier": "~1.0.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"type": "opencollective",
|
||||||
|
"url": "https://opencollective.com/express"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/iconv-lite": {
|
||||||
|
"version": "0.4.24",
|
||||||
|
"resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
|
||||||
|
"integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"safer-buffer": ">= 2.1.2 < 3"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=0.10.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/inherits": {
|
||||||
|
"version": "2.0.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
|
||||||
|
"integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
|
||||||
|
"license": "ISC"
|
||||||
|
},
|
||||||
|
"node_modules/ipaddr.js": {
|
||||||
|
"version": "1.9.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
|
||||||
|
"integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.10"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/math-intrinsics": {
|
||||||
|
"version": "1.1.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
|
||||||
|
"integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/media-typer": {
|
||||||
|
"version": "0.3.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz",
|
||||||
|
"integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/merge-descriptors": {
|
||||||
|
"version": "1.0.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz",
|
||||||
|
"integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==",
|
||||||
|
"license": "MIT",
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/sindresorhus"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/methods": {
|
||||||
|
"version": "1.1.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz",
|
||||||
|
"integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/mime": {
|
||||||
|
"version": "1.6.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz",
|
||||||
|
"integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==",
|
||||||
|
"license": "MIT",
|
||||||
|
"bin": {
|
||||||
|
"mime": "cli.js"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=4"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/mime-db": {
|
||||||
|
"version": "1.52.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
|
||||||
|
"integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/mime-types": {
|
||||||
|
"version": "2.1.35",
|
||||||
|
"resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
|
||||||
|
"integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"mime-db": "1.52.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/ms": {
|
||||||
|
"version": "2.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
|
||||||
|
"integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/negotiator": {
|
||||||
|
"version": "0.6.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz",
|
||||||
|
"integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/object-inspect": {
|
||||||
|
"version": "1.13.4",
|
||||||
|
"resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
|
||||||
|
"integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/on-finished": {
|
||||||
|
"version": "2.4.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
|
||||||
|
"integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"ee-first": "1.1.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/parseurl": {
|
||||||
|
"version": "1.3.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
|
||||||
|
"integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/path-to-regexp": {
|
||||||
|
"version": "0.1.13",
|
||||||
|
"resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.13.tgz",
|
||||||
|
"integrity": "sha512-A/AGNMFN3c8bOlvV9RreMdrv7jsmF9XIfDeCd87+I8RNg6s78BhJxMu69NEMHBSJFxKidViTEdruRwEk/WIKqA==",
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/proxy-addr": {
|
||||||
|
"version": "2.0.8",
|
||||||
|
"resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.8.tgz",
|
||||||
|
"integrity": "sha512-5nnx0yGyVUcY6t9RnWcARWtwT9F1D8O9rt08htPvnd49W1IgZtmLkhu9WfMzQj1cFxjHIO6connUNVW5k7AVyQ==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"forwarded": "0.2.0",
|
||||||
|
"ipaddr.js": "1.9.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.10"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"type": "opencollective",
|
||||||
|
"url": "https://opencollective.com/express"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/qs": {
|
||||||
|
"version": "6.16.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/qs/-/qs-6.16.0.tgz",
|
||||||
|
"integrity": "sha512-h6fhOIaRrID2CbEY2fqs+7t+UXZo+MLAnU5gRIq85uFtdiUPCdsApMlHhXogKVM4HM2DVbIjGNTTYH2OcmP1vA==",
|
||||||
|
"license": "BSD-3-Clause",
|
||||||
|
"dependencies": {
|
||||||
|
"es-define-property": "^1.0.1",
|
||||||
|
"side-channel": "^1.1.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=0.6"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/range-parser": {
|
||||||
|
"version": "1.2.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
|
||||||
|
"integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/raw-body": {
|
||||||
|
"version": "2.5.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.3.tgz",
|
||||||
|
"integrity": "sha512-s4VSOf6yN0rvbRZGxs8Om5CWj6seneMwK3oDb4lWDH0UPhWcxwOWw5+qk24bxq87szX1ydrwylIOp2uG1ojUpA==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"bytes": "~3.1.2",
|
||||||
|
"http-errors": "~2.0.1",
|
||||||
|
"iconv-lite": "~0.4.24",
|
||||||
|
"unpipe": "~1.0.0"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/safe-buffer": {
|
||||||
|
"version": "5.2.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
|
||||||
|
"integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
|
||||||
|
"funding": [
|
||||||
|
{
|
||||||
|
"type": "github",
|
||||||
|
"url": "https://github.com/sponsors/feross"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "patreon",
|
||||||
|
"url": "https://www.patreon.com/feross"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "consulting",
|
||||||
|
"url": "https://feross.org/support"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/safer-buffer": {
|
||||||
|
"version": "2.1.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
|
||||||
|
"integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/send": {
|
||||||
|
"version": "0.19.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/send/-/send-0.19.2.tgz",
|
||||||
|
"integrity": "sha512-VMbMxbDeehAxpOtWJXlcUS5E8iXh6QmN+BkRX1GARS3wRaXEEgzCcB10gTQazO42tpNIya8xIyNx8fll1OFPrg==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"debug": "2.6.9",
|
||||||
|
"depd": "2.0.0",
|
||||||
|
"destroy": "1.2.0",
|
||||||
|
"encodeurl": "~2.0.0",
|
||||||
|
"escape-html": "~1.0.3",
|
||||||
|
"etag": "~1.8.1",
|
||||||
|
"fresh": "~0.5.2",
|
||||||
|
"http-errors": "~2.0.1",
|
||||||
|
"mime": "1.6.0",
|
||||||
|
"ms": "2.1.3",
|
||||||
|
"on-finished": "~2.4.1",
|
||||||
|
"range-parser": "~1.2.1",
|
||||||
|
"statuses": "~2.0.2"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/send/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==",
|
||||||
|
"license": "MIT"
|
||||||
|
},
|
||||||
|
"node_modules/serve-static": {
|
||||||
|
"version": "1.16.3",
|
||||||
|
"resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.3.tgz",
|
||||||
|
"integrity": "sha512-x0RTqQel6g5SY7Lg6ZreMmsOzncHFU7nhnRWkKgWuMTu5NN0DR5oruckMqRvacAN9d5w6ARnRBXl9xhDCgfMeA==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"encodeurl": "~2.0.0",
|
||||||
|
"escape-html": "~1.0.3",
|
||||||
|
"parseurl": "~1.3.3",
|
||||||
|
"send": "~0.19.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/setprototypeof": {
|
||||||
|
"version": "1.2.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
|
||||||
|
"integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
|
||||||
|
"license": "ISC"
|
||||||
|
},
|
||||||
|
"node_modules/side-channel": {
|
||||||
|
"version": "1.1.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.1.tgz",
|
||||||
|
"integrity": "sha512-6x6dK6zJdpTzF4sQeNYxwtvBzf6Eg4GtlesS94HOvTudUeyK2WXAaIfmDgsyslYrRBeFIlsi54AYsFGUuhmvrQ==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"es-errors": "^1.3.0",
|
||||||
|
"object-inspect": "^1.13.4",
|
||||||
|
"side-channel-list": "^1.0.1",
|
||||||
|
"side-channel-map": "^1.0.1",
|
||||||
|
"side-channel-weakmap": "^1.0.2"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/side-channel-list": {
|
||||||
|
"version": "1.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.1.tgz",
|
||||||
|
"integrity": "sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"es-errors": "^1.3.0",
|
||||||
|
"object-inspect": "^1.13.4"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/side-channel-map": {
|
||||||
|
"version": "1.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
|
||||||
|
"integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"call-bound": "^1.0.2",
|
||||||
|
"es-errors": "^1.3.0",
|
||||||
|
"get-intrinsic": "^1.2.5",
|
||||||
|
"object-inspect": "^1.13.3"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/side-channel-weakmap": {
|
||||||
|
"version": "1.0.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
|
||||||
|
"integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"call-bound": "^1.0.2",
|
||||||
|
"es-errors": "^1.3.0",
|
||||||
|
"get-intrinsic": "^1.2.5",
|
||||||
|
"object-inspect": "^1.13.3",
|
||||||
|
"side-channel-map": "^1.0.1"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4"
|
||||||
|
},
|
||||||
|
"funding": {
|
||||||
|
"url": "https://github.com/sponsors/ljharb"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/statuses": {
|
||||||
|
"version": "2.0.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
|
||||||
|
"integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/toidentifier": {
|
||||||
|
"version": "1.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
|
||||||
|
"integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">=0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/type-is": {
|
||||||
|
"version": "1.6.18",
|
||||||
|
"resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz",
|
||||||
|
"integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==",
|
||||||
|
"license": "MIT",
|
||||||
|
"dependencies": {
|
||||||
|
"media-typer": "0.3.0",
|
||||||
|
"mime-types": "~2.1.24"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.6"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/unpipe": {
|
||||||
|
"version": "1.0.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
|
||||||
|
"integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/utils-merge": {
|
||||||
|
"version": "1.0.1",
|
||||||
|
"resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz",
|
||||||
|
"integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.4.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/vary": {
|
||||||
|
"version": "1.1.2",
|
||||||
|
"resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
|
||||||
|
"integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
|
||||||
|
"license": "MIT",
|
||||||
|
"engines": {
|
||||||
|
"node": ">= 0.8"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
{
|
||||||
|
"name": "tv-adb-remote-server",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"description": "Local server that bridges a web/PWA remote control to Android TV over ADB",
|
||||||
|
"type": "module",
|
||||||
|
"main": "src/index.js",
|
||||||
|
"scripts": {
|
||||||
|
"start": "node src/index.js",
|
||||||
|
"test": "node --test test/*.test.js"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"express": "^4.19.2"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,111 @@
|
|||||||
|
import { execFile } from "node:child_process";
|
||||||
|
import { promisify } from "node:util";
|
||||||
|
|
||||||
|
const execFileAsync = promisify(execFile);
|
||||||
|
|
||||||
|
const ADB_BIN = process.env.ADB_BIN || "adb";
|
||||||
|
const EXEC_TIMEOUT_MS = 8000;
|
||||||
|
|
||||||
|
class AdbError extends Error {
|
||||||
|
constructor(message, { code, stderr } = {}) {
|
||||||
|
super(message);
|
||||||
|
this.name = "AdbError";
|
||||||
|
this.code = code;
|
||||||
|
this.stderr = stderr;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function run(args) {
|
||||||
|
return execFileAsync(ADB_BIN, args, { timeout: EXEC_TIMEOUT_MS }).catch((err) => {
|
||||||
|
if (err.code === "ENOENT") {
|
||||||
|
throw new AdbError(
|
||||||
|
"adb binary not found on this machine. Install Android platform-tools and make sure `adb` is on PATH.",
|
||||||
|
{ code: "ADB_NOT_FOUND" }
|
||||||
|
);
|
||||||
|
}
|
||||||
|
throw new AdbError(err.stderr?.trim() || err.message, {
|
||||||
|
code: "ADB_COMMAND_FAILED",
|
||||||
|
stderr: err.stderr,
|
||||||
|
});
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
// Accepts "host" or "host:port" and rejects anything that isn't a plausible
|
||||||
|
// address, since this value is passed straight to execFile as a single arg
|
||||||
|
// (no shell involved, but we still don't want to hand adb garbage).
|
||||||
|
const HOST_PORT_RE = /^[a-zA-Z0-9.\-]+(:\d{1,5})?$/;
|
||||||
|
|
||||||
|
export function normalizeTarget(hostOrHostPort) {
|
||||||
|
const trimmed = String(hostOrHostPort || "").trim();
|
||||||
|
if (!HOST_PORT_RE.test(trimmed)) {
|
||||||
|
throw new AdbError(`"${hostOrHostPort}" doesn't look like a valid host or host:port`, {
|
||||||
|
code: "INVALID_TARGET",
|
||||||
|
});
|
||||||
|
}
|
||||||
|
return trimmed.includes(":") ? trimmed : `${trimmed}:5555`;
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function connect(hostOrHostPort) {
|
||||||
|
const target = normalizeTarget(hostOrHostPort);
|
||||||
|
const { stdout } = await run(["connect", target]);
|
||||||
|
const text = stdout.trim();
|
||||||
|
// adb prints "failed to connect..." on stdout with exit code 0, so we
|
||||||
|
// have to sniff the message instead of relying on the exit status.
|
||||||
|
if (/failed|unable|cannot/i.test(text)) {
|
||||||
|
throw new AdbError(text, { code: "CONNECT_FAILED" });
|
||||||
|
}
|
||||||
|
return { target, message: text };
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function disconnect(hostOrHostPort) {
|
||||||
|
const target = normalizeTarget(hostOrHostPort);
|
||||||
|
const { stdout } = await run(["disconnect", target]);
|
||||||
|
return { target, message: stdout.trim() };
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function pair(hostAndPort, code) {
|
||||||
|
if (!/^\d{6}$/.test(String(code))) {
|
||||||
|
throw new AdbError("Pairing code must be exactly 6 digits", { code: "INVALID_PAIR_CODE" });
|
||||||
|
}
|
||||||
|
const target = normalizeTarget(hostAndPort);
|
||||||
|
const { stdout } = await run(["pair", target, String(code)]);
|
||||||
|
const text = stdout.trim();
|
||||||
|
if (/failed|unable|cannot/i.test(text)) {
|
||||||
|
throw new AdbError(text, { code: "PAIR_FAILED" });
|
||||||
|
}
|
||||||
|
return { target, message: text };
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function listDevices() {
|
||||||
|
const { stdout } = await run(["devices", "-l"]);
|
||||||
|
return stdout
|
||||||
|
.split("\n")
|
||||||
|
.slice(1)
|
||||||
|
.map((line) => line.trim())
|
||||||
|
.filter(Boolean)
|
||||||
|
.map((line) => {
|
||||||
|
const [serial, state, ...rest] = line.split(/\s+/);
|
||||||
|
return { serial, state, details: rest.join(" ") };
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function shell(serial, ...shellArgs) {
|
||||||
|
const target = normalizeTarget(serial);
|
||||||
|
return run(["-s", target, "shell", ...shellArgs]);
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function keyevent(serial, code) {
|
||||||
|
await shell(serial, "input", "keyevent", String(code));
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function sendText(serial, text) {
|
||||||
|
// Android's `input text` treats spaces specially; %s is the documented escape.
|
||||||
|
const escaped = String(text).replace(/ /g, "%s");
|
||||||
|
await shell(serial, "input", "text", escaped);
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function launchApp(serial, packageName) {
|
||||||
|
await shell(serial, "monkey", "-p", packageName, "-c", "android.intent.category.LAUNCHER", "1");
|
||||||
|
}
|
||||||
|
|
||||||
|
export { AdbError };
|
||||||
@@ -0,0 +1,49 @@
|
|||||||
|
import { readFile, writeFile, mkdir } from "node:fs/promises";
|
||||||
|
import { dirname } from "node:path";
|
||||||
|
import { randomUUID } from "node:crypto";
|
||||||
|
|
||||||
|
const DATA_FILE = process.env.DEVICES_FILE || new URL("../../data/devices.json", import.meta.url).pathname;
|
||||||
|
|
||||||
|
async function load() {
|
||||||
|
try {
|
||||||
|
const raw = await readFile(DATA_FILE, "utf8");
|
||||||
|
const parsed = JSON.parse(raw);
|
||||||
|
return Array.isArray(parsed.devices) ? parsed.devices : [];
|
||||||
|
} catch (err) {
|
||||||
|
if (err.code === "ENOENT") return [];
|
||||||
|
throw err;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function save(devices) {
|
||||||
|
await mkdir(dirname(DATA_FILE), { recursive: true });
|
||||||
|
await writeFile(DATA_FILE, JSON.stringify({ devices }, null, 2), "utf8");
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function listSavedDevices() {
|
||||||
|
return load();
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function addSavedDevice({ name, host }) {
|
||||||
|
const devices = await load();
|
||||||
|
const device = { id: randomUUID(), name: name || host, host };
|
||||||
|
devices.push(device);
|
||||||
|
await save(devices);
|
||||||
|
return device;
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function removeSavedDevice(id) {
|
||||||
|
const devices = await load();
|
||||||
|
const next = devices.filter((d) => d.id !== id);
|
||||||
|
await save(next);
|
||||||
|
return next.length !== devices.length;
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function updateSavedDevice(id, patch) {
|
||||||
|
const devices = await load();
|
||||||
|
const idx = devices.findIndex((d) => d.id === id);
|
||||||
|
if (idx === -1) return null;
|
||||||
|
devices[idx] = { ...devices[idx], ...patch };
|
||||||
|
await save(devices);
|
||||||
|
return devices[idx];
|
||||||
|
}
|
||||||
@@ -0,0 +1,179 @@
|
|||||||
|
import express from "express";
|
||||||
|
import { fileURLToPath } from "node:url";
|
||||||
|
import { dirname, join } from "node:path";
|
||||||
|
|
||||||
|
import * as adb from "./adb.js";
|
||||||
|
import { KEYCODES, isValidKeycodeName } from "./keycodes.js";
|
||||||
|
import {
|
||||||
|
listSavedDevices,
|
||||||
|
addSavedDevice,
|
||||||
|
removeSavedDevice,
|
||||||
|
updateSavedDevice,
|
||||||
|
} from "./deviceStore.js";
|
||||||
|
|
||||||
|
const __dirname = dirname(fileURLToPath(import.meta.url));
|
||||||
|
const PUBLIC_DIR = join(__dirname, "..", "..", "public");
|
||||||
|
const PORT = process.env.PORT || 8787;
|
||||||
|
|
||||||
|
const app = express();
|
||||||
|
app.use(express.json());
|
||||||
|
app.use(express.static(PUBLIC_DIR));
|
||||||
|
|
||||||
|
function handle(fn) {
|
||||||
|
return async (req, res) => {
|
||||||
|
try {
|
||||||
|
await fn(req, res);
|
||||||
|
} catch (err) {
|
||||||
|
const status = err.name === "AdbError" ? 502 : 400;
|
||||||
|
res.status(status).json({ error: err.message, code: err.code });
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
async function requireDevice(req) {
|
||||||
|
const devices = await listSavedDevices();
|
||||||
|
const device = devices.find((d) => d.id === req.params.id);
|
||||||
|
if (!device) {
|
||||||
|
const err = new Error("Unknown device id");
|
||||||
|
err.code = "DEVICE_NOT_FOUND";
|
||||||
|
throw err;
|
||||||
|
}
|
||||||
|
return device;
|
||||||
|
}
|
||||||
|
|
||||||
|
app.get("/api/health", (req, res) => res.json({ ok: true }));
|
||||||
|
|
||||||
|
app.get("/api/keycodes", (req, res) => res.json({ keycodes: Object.keys(KEYCODES) }));
|
||||||
|
|
||||||
|
app.get(
|
||||||
|
"/api/devices",
|
||||||
|
handle(async (req, res) => {
|
||||||
|
const [saved, live] = await Promise.all([listSavedDevices(), adb.listDevices().catch(() => [])]);
|
||||||
|
const liveBySerial = new Map(live.map((d) => [d.serial, d]));
|
||||||
|
const merged = saved.map((d) => {
|
||||||
|
const port = d.host.includes(":") ? d.host : `${d.host}:5555`;
|
||||||
|
const liveMatch = liveBySerial.get(port);
|
||||||
|
return { ...d, status: liveMatch?.state || "disconnected" };
|
||||||
|
});
|
||||||
|
res.json({ devices: merged });
|
||||||
|
})
|
||||||
|
);
|
||||||
|
|
||||||
|
app.post(
|
||||||
|
"/api/devices",
|
||||||
|
handle(async (req, res) => {
|
||||||
|
const { name, host } = req.body || {};
|
||||||
|
if (!host) {
|
||||||
|
const err = new Error("host is required");
|
||||||
|
err.code = "MISSING_HOST";
|
||||||
|
throw err;
|
||||||
|
}
|
||||||
|
adb.normalizeTarget(host); // validate early with a clear error
|
||||||
|
const device = await addSavedDevice({ name, host });
|
||||||
|
res.status(201).json({ device });
|
||||||
|
})
|
||||||
|
);
|
||||||
|
|
||||||
|
app.delete(
|
||||||
|
"/api/devices/:id",
|
||||||
|
handle(async (req, res) => {
|
||||||
|
const removed = await removeSavedDevice(req.params.id);
|
||||||
|
if (!removed) return res.status(404).json({ error: "Unknown device id" });
|
||||||
|
res.json({ ok: true });
|
||||||
|
})
|
||||||
|
);
|
||||||
|
|
||||||
|
app.post(
|
||||||
|
"/api/devices/:id/connect",
|
||||||
|
handle(async (req, res) => {
|
||||||
|
const device = await requireDevice(req);
|
||||||
|
const result = await adb.connect(device.host);
|
||||||
|
res.json(result);
|
||||||
|
})
|
||||||
|
);
|
||||||
|
|
||||||
|
app.post(
|
||||||
|
"/api/devices/:id/disconnect",
|
||||||
|
handle(async (req, res) => {
|
||||||
|
const device = await requireDevice(req);
|
||||||
|
const result = await adb.disconnect(device.host);
|
||||||
|
res.json(result);
|
||||||
|
})
|
||||||
|
);
|
||||||
|
|
||||||
|
app.post(
|
||||||
|
"/api/devices/:id/pair",
|
||||||
|
handle(async (req, res) => {
|
||||||
|
const device = await requireDevice(req);
|
||||||
|
const { pairHost, code } = req.body || {};
|
||||||
|
if (!pairHost || !code) {
|
||||||
|
const err = new Error("pairHost and code are required");
|
||||||
|
err.code = "MISSING_PAIR_INFO";
|
||||||
|
throw err;
|
||||||
|
}
|
||||||
|
const result = await adb.pair(pairHost, code);
|
||||||
|
// Once paired, Android TV also opens the normal debugging port, so try
|
||||||
|
// connecting on the device's saved host right after.
|
||||||
|
await adb.connect(device.host).catch(() => {});
|
||||||
|
res.json(result);
|
||||||
|
})
|
||||||
|
);
|
||||||
|
|
||||||
|
app.post(
|
||||||
|
"/api/devices/:id/key",
|
||||||
|
handle(async (req, res) => {
|
||||||
|
const device = await requireDevice(req);
|
||||||
|
const { key } = req.body || {};
|
||||||
|
if (!isValidKeycodeName(key)) {
|
||||||
|
const err = new Error(`Unknown key "${key}"`);
|
||||||
|
err.code = "UNKNOWN_KEY";
|
||||||
|
throw err;
|
||||||
|
}
|
||||||
|
await adb.keyevent(device.host, KEYCODES[key]);
|
||||||
|
res.json({ ok: true, key });
|
||||||
|
})
|
||||||
|
);
|
||||||
|
|
||||||
|
app.post(
|
||||||
|
"/api/devices/:id/text",
|
||||||
|
handle(async (req, res) => {
|
||||||
|
const device = await requireDevice(req);
|
||||||
|
const { text } = req.body || {};
|
||||||
|
if (typeof text !== "string" || !text.length) {
|
||||||
|
const err = new Error("text is required");
|
||||||
|
err.code = "MISSING_TEXT";
|
||||||
|
throw err;
|
||||||
|
}
|
||||||
|
await adb.sendText(device.host, text);
|
||||||
|
res.json({ ok: true });
|
||||||
|
})
|
||||||
|
);
|
||||||
|
|
||||||
|
app.post(
|
||||||
|
"/api/devices/:id/app",
|
||||||
|
handle(async (req, res) => {
|
||||||
|
const device = await requireDevice(req);
|
||||||
|
const { package: packageName } = req.body || {};
|
||||||
|
if (!packageName) {
|
||||||
|
const err = new Error("package is required");
|
||||||
|
err.code = "MISSING_PACKAGE";
|
||||||
|
throw err;
|
||||||
|
}
|
||||||
|
await adb.launchApp(device.host, packageName);
|
||||||
|
res.json({ ok: true });
|
||||||
|
})
|
||||||
|
);
|
||||||
|
|
||||||
|
app.patch(
|
||||||
|
"/api/devices/:id",
|
||||||
|
handle(async (req, res) => {
|
||||||
|
const { name } = req.body || {};
|
||||||
|
const updated = await updateSavedDevice(req.params.id, { name });
|
||||||
|
if (!updated) return res.status(404).json({ error: "Unknown device id" });
|
||||||
|
res.json({ device: updated });
|
||||||
|
})
|
||||||
|
);
|
||||||
|
|
||||||
|
app.listen(PORT, () => {
|
||||||
|
console.log(`TV ADB Remote server listening on http://0.0.0.0:${PORT}`);
|
||||||
|
});
|
||||||
@@ -0,0 +1,33 @@
|
|||||||
|
// Android KeyEvent codes used by `adb shell input keyevent <code>`.
|
||||||
|
// Reference: https://developer.android.com/reference/android/view/KeyEvent
|
||||||
|
export const KEYCODES = {
|
||||||
|
POWER: 26,
|
||||||
|
SLEEP: 223,
|
||||||
|
WAKEUP: 224,
|
||||||
|
HOME: 3,
|
||||||
|
BACK: 4,
|
||||||
|
MENU: 82,
|
||||||
|
DPAD_UP: 19,
|
||||||
|
DPAD_DOWN: 20,
|
||||||
|
DPAD_LEFT: 21,
|
||||||
|
DPAD_RIGHT: 22,
|
||||||
|
DPAD_CENTER: 23,
|
||||||
|
VOLUME_UP: 24,
|
||||||
|
VOLUME_DOWN: 25,
|
||||||
|
VOLUME_MUTE: 164,
|
||||||
|
CHANNEL_UP: 166,
|
||||||
|
CHANNEL_DOWN: 167,
|
||||||
|
TV_INPUT: 178,
|
||||||
|
TV_INPUT_HDMI_1: 243,
|
||||||
|
TV_INPUT_HDMI_2: 244,
|
||||||
|
TV_INPUT_HDMI_3: 245,
|
||||||
|
MEDIA_PLAY_PAUSE: 85,
|
||||||
|
MEDIA_REWIND: 89,
|
||||||
|
MEDIA_FAST_FORWARD: 90,
|
||||||
|
SETTINGS: 176,
|
||||||
|
INFO: 165,
|
||||||
|
};
|
||||||
|
|
||||||
|
export function isValidKeycodeName(name) {
|
||||||
|
return Object.prototype.hasOwnProperty.call(KEYCODES, name);
|
||||||
|
}
|
||||||
@@ -0,0 +1,36 @@
|
|||||||
|
import { test } from "node:test";
|
||||||
|
import assert from "node:assert/strict";
|
||||||
|
import * as adb from "../src/adb.js";
|
||||||
|
|
||||||
|
test("normalizeTarget adds default port 5555", () => {
|
||||||
|
assert.equal(adb.normalizeTarget("192.168.1.50"), "192.168.1.50:5555");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("normalizeTarget keeps an explicit port", () => {
|
||||||
|
assert.equal(adb.normalizeTarget("192.168.1.50:5556"), "192.168.1.50:5556");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("normalizeTarget trims whitespace", () => {
|
||||||
|
assert.equal(adb.normalizeTarget(" 192.168.1.50 "), "192.168.1.50:5555");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("normalizeTarget rejects shell-hostile input", () => {
|
||||||
|
assert.throws(() => adb.normalizeTarget("1.2.3.4; rm -rf /"), /doesn't look like/);
|
||||||
|
});
|
||||||
|
|
||||||
|
test("normalizeTarget rejects empty input", () => {
|
||||||
|
assert.throws(() => adb.normalizeTarget(""), /doesn't look like/);
|
||||||
|
});
|
||||||
|
|
||||||
|
test("connect() rejects cleanly against a closed local port instead of hanging", async () => {
|
||||||
|
// Nothing listens on 5599 locally, so `adb connect` should fail fast with
|
||||||
|
// a normal error rather than the process throwing an unhandled exception.
|
||||||
|
await assert.rejects(adb.connect("127.0.0.1:5599"), (err) => {
|
||||||
|
assert.equal(err.name, "AdbError");
|
||||||
|
return true;
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
test("pair() rejects a non-6-digit code before touching adb", async () => {
|
||||||
|
await assert.rejects(adb.pair("127.0.0.1:5599", "12"), /6 digits/);
|
||||||
|
});
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
import { test } from "node:test";
|
||||||
|
import assert from "node:assert/strict";
|
||||||
|
import { mkdtemp, rm } from "node:fs/promises";
|
||||||
|
import { tmpdir } from "node:os";
|
||||||
|
import { join } from "node:path";
|
||||||
|
|
||||||
|
test("deviceStore add/list/update/remove roundtrip", async () => {
|
||||||
|
const dir = await mkdtemp(join(tmpdir(), "tv-remote-test-"));
|
||||||
|
process.env.DEVICES_FILE = join(dir, "devices.json");
|
||||||
|
|
||||||
|
// Import fresh so it picks up the env var above.
|
||||||
|
const store = await import(`../src/deviceStore.js?t=${Date.now()}`);
|
||||||
|
|
||||||
|
assert.deepEqual(await store.listSavedDevices(), []);
|
||||||
|
|
||||||
|
const device = await store.addSavedDevice({ name: "Living Room", host: "192.168.1.50" });
|
||||||
|
assert.equal(device.name, "Living Room");
|
||||||
|
assert.ok(device.id);
|
||||||
|
|
||||||
|
let list = await store.listSavedDevices();
|
||||||
|
assert.equal(list.length, 1);
|
||||||
|
|
||||||
|
const updated = await store.updateSavedDevice(device.id, { name: "Lounge" });
|
||||||
|
assert.equal(updated.name, "Lounge");
|
||||||
|
|
||||||
|
const removed = await store.removeSavedDevice(device.id);
|
||||||
|
assert.equal(removed, true);
|
||||||
|
|
||||||
|
list = await store.listSavedDevices();
|
||||||
|
assert.equal(list.length, 0);
|
||||||
|
|
||||||
|
await rm(dir, { recursive: true, force: true });
|
||||||
|
delete process.env.DEVICES_FILE;
|
||||||
|
});
|
||||||
Reference in New Issue
Block a user