@ohmykreee/dsh-remote-control 0.0.0-stage → 1.0.3

package/scripts/screenshot-device.sh

@@ -0,0 +1,75 @@
+#!/usr/bin/env bash
+# Capture the real device screen (never a headless browser viewport).
+#
+# Run this on the machine whose physical display should appear in the docs:
+#
+#   URL='http://192.0.2.20:4173/?page=home' \
+#   OUT=shots/dark-home.png \
+#   scripts/screenshot-device.sh
+#
+# For the question sheet use:
+#   URL='http://192.0.2.20:4173/?page=home&sheet=1'
+#
+# Optional environment:
+#   SETTLE=6          seconds to wait after opening the kiosk browser
+#   CAPTURE=auto      auto | spectacle | grim | import
+#   BROWSER=firefox   browser used for the kiosk window
+#
+# When run over SSH into a Wayland desktop, export the session's
+# XDG_RUNTIME_DIR, WAYLAND_DISPLAY and DBUS_SESSION_BUS_ADDRESS first.
+# Spectacle (KDE) or grim (wlroots) is needed under Wayland; ImageMagick
+# `import` can capture X11/Xwayland screens.
+set -euo pipefail
+
+if [ -z "${URL:-}" ] || [ -z "${OUT:-}" ]; then
+  echo "usage: URL='http://host:4173/?page=home' OUT=shots/dark-home.png $0" >&2
+  exit 2
+fi
+
+browser="${BROWSER:-firefox}"
+settle="${SETTLE:-6}"
+workdir="${WORKDIR:-$(mktemp -d)}"
+profile="$workdir/profile"
+mkdir -p "$profile" "$(dirname "$OUT")"
+
+cleanup() {
+  pkill -f "firefox.*${profile}" 2>/dev/null || true
+  if [ "${KEEP_WORKDIR:-0}" != "1" ]; then
+    rm -rf "$workdir"
+  fi
+}
+trap cleanup EXIT
+
+MOZ_ENABLE_WAYLAND=1 nohup "$browser" --kiosk --no-remote --profile "$profile" "$URL" \
+  >"$workdir/browser.log" 2>&1 &
+sleep "$settle"
+
+capture="${CAPTURE:-auto}"
+if [ "$capture" = "auto" ]; then
+  if command -v spectacle >/dev/null 2>&1; then
+    capture="spectacle"
+  elif command -v grim >/dev/null 2>&1; then
+    capture="grim"
+  elif command -v import >/dev/null 2>&1; then
+    capture="import"
+  else
+    echo "no screenshot tool found; install spectacle (KDE), grim (wlroots) or ImageMagick" >&2
+    exit 1
+  fi
+fi
+
+case "$capture" in
+  spectacle) spectacle --fullscreen --background --nonotify --output "$OUT" ;;
+  grim) grim "$OUT" ;;
+  import) import -window root "$OUT" ;;
+  *) echo "unknown CAPTURE=$capture" >&2; exit 2 ;;
+esac
+
+sleep 1
+if [ ! -s "$OUT" ]; then
+  echo "screen capture failed; browser log follows" >&2
+  cat "$workdir/browser.log" >&2
+  exit 1
+fi
+
+ls -l "$OUT"

package/src/dsh/client/api.ts

@@ -0,0 +1,68 @@
+/**
+ * Loopback API helpers for the DSH sidebar page.
+ *
+ * Every request is same-origin and uncached; errors carry the JSON `error`
+ * field when the Host supplies one.
+ */
+
+import type { RemoteClient, SettingsPayload } from './types.js';
+
+export const SETTINGS_URL = '/dsh-remote-control/api/settings';
+export const APP_NAMES_URL = '/dsh-remote-control/api/apps';
+export const LOCATION_URL = '/dsh-remote-control/api/location';
+export const GEOCODE_URL = '/dsh-remote-control/api/geocode';
+export const THEME_URL = '/dsh-remote-control/api/theme';
+export const LOCALE_URL = '/dsh-remote-control/api/locale';
+export const TOKEN_URL = '/dsh-remote-control/api/token/rotate';
+export const DISCONNECT_URL = '/dsh-remote-control/api/disconnect';
+
+export function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+export function isSettingsPayload(value: unknown): value is SettingsPayload {
+  return isRecord(value) && isRecord(value.settings);
+}
+
+export function errorText(value: unknown): string | undefined {
+  const error = isRecord(value) ? value.error : undefined;
+  return error ? String(error) : undefined;
+}
+
+export function describeError(error: unknown): string {
+  const message = isRecord(error) ? error.message : undefined;
+  return message ? String(message) : String(error);
+}
+
+function isRemoteClient(value: unknown): value is RemoteClient {
+  return isRecord(value) && typeof value.id === 'string' && typeof value.ip === 'string' && typeof value.connectedAt === 'number';
+}
+
+export function readClients(value: unknown): RemoteClient[] {
+  const list: unknown[] = isRecord(value) && Array.isArray(value.clients) ? value.clients : [];
+  return list.filter(isRemoteClient);
+}
+
+/** Fetch JSON from a loopback route and turn non-2xx responses into errors. */
+export async function requestJson(url: string, init: RequestInit = {}): Promise<unknown> {
+  const response = await fetch(url, {
+    credentials: 'same-origin',
+    cache: 'no-store',
+    ...init,
+    headers: {
+      ...(init.body === undefined ? {} : { 'content-type': 'application/json' }),
+      ...(init.headers ?? {}),
+    },
+  });
+  const payload: unknown = await response.json().catch(() => null);
+  if (!response.ok) throw new Error(errorText(payload) || `HTTP ${response.status}`);
+  return payload;
+}
+
+/** POST a JSON body to a loopback route. */
+export function postJson(url: string, body?: unknown): Promise<unknown> {
+  return requestJson(url, {
+    method: 'POST',
+    ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+  });
+}