@livedesk/client 0.1.52 → 0.1.53

package/README.md

@@ -13,6 +13,10 @@ ready yet, the client keeps checking every 5 seconds instead of exiting. Omit th
 number for first-available placement, or pass `1` to `999` to pin this machine
 to a screen wall slot.
 
+On Windows, check **Start with Windows** on the connection page to reconnect this
+client automatically after reboot. The startup entry reuses the saved Google
+session and only opens the connection page again if sign-in is needed.
+
 On the Hub computer, open the LiveDesk dashboard and sign in first. The
 dashboard keeps its local Hub address and private pair token refreshed in the
 LiveDesk Supabase registry for the signed-in account.

package/bin/livedesk-client.js

@@ -20,6 +20,8 @@ const DEFAULT_AUTH_CALLBACK_PORT = 5198;
 const DISCOVERY_RETRY_MS = 5000;
 const EXIT_INVALID_PAIR_TOKEN = 23;
 const SESSION_REFRESH_SKEW_SECONDS = 60;
+const WINDOWS_STARTUP_SCRIPT_NAME = 'LiveDesk Client.vbs';
+const WINDOWS_STARTUP_LEGACY_CMD_NAME = 'LiveDesk Client.cmd';
 const SUPABASE_URL = process.env.LIVEDESK_SUPABASE_URL || 'https://otbyfkjxrkngvjziawki.supabase.co';
 const SUPABASE_PUBLISHABLE_KEY = process.env.LIVEDESK_SUPABASE_PUBLISHABLE_KEY || 'sb_publishable_NpUs0RDJH2YnllsqTKO6TQ_1jTdSsNQ';
 const CLIENT_STATE_DIR = join(os.homedir(), '.livedesk-client');
@@ -64,6 +66,7 @@ Options:
 
 Auto uses C# RemoteFast when supported and falls back to Node for AI assist or
 when a packaged RemoteFast runtime is unavailable.
+Enable Windows auto-start from the connection page when this client signs in.
 `.trimStart());
 }
 
@@ -106,6 +109,7 @@ function parseLauncherArgs(argv) {
     let command = 'connect';
     let nodeOnlyFeature = false;
     let fakeThumbnail = false;
+    let startupRun = false;
 
     for (let index = 0; index < argv.length; index += 1) {
         const arg = argv[index];
@@ -157,6 +161,10 @@ function parseLauncherArgs(argv) {
             index += 1;
             continue;
         }
+        if (arg === '--startup-run') {
+            startupRun = true;
+            continue;
+        }
         if (arg === '--manager') {
             manager = argv[index + 1] || manager;
             forwarded.push(arg, argv[index + 1]);
@@ -208,7 +216,8 @@ function parseLauncherArgs(argv) {
         slot,
         authPort,
         nodeOnlyFeature,
-        fakeThumbnail
+        fakeThumbnail,
+        startupRun
     };
 }
 
@@ -249,6 +258,119 @@ function appendForwardedFlag(args, flag) {
     return [...args, flag];
 }
 
+function getWindowsStartupDir() {
+    const appData = process.env.APPDATA || join(os.homedir(), 'AppData', 'Roaming');
+    return join(appData, 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup');
+}
+
+function getWindowsStartupScriptPath() {
+    return join(getWindowsStartupDir(), WINDOWS_STARTUP_SCRIPT_NAME);
+}
+
+function getLegacyWindowsStartupCommandPath() {
+    return join(getWindowsStartupDir(), WINDOWS_STARTUP_LEGACY_CMD_NAME);
+}
+
+function isWindowsStartupSupported() {
+    return os.platform() === 'win32';
+}
+
+function isWindowsStartupRegistered() {
+    return isWindowsStartupSupported() && existsSync(getWindowsStartupScriptPath());
+}
+
+function quoteCommandArg(value) {
+    const text = String(value ?? '');
+    if (/^[A-Za-z0-9@._:/=+-]+$/.test(text)) {
+        return text;
+    }
+    return `"${text.replaceAll('"', '\\"')}"`;
+}
+
+function escapeVbsString(value) {
+    return String(value ?? '').replaceAll('"', '""');
+}
+
+function buildStartupClientArgs(parsed) {
+    const args = [];
+    const slot = normalizeSlotNumber(parsed.slot);
+    if (slot) {
+        args.push(slot);
+    }
+    if (parsed.engine === 'fast') {
+        args.push('--fast');
+    } else if (parsed.engine === 'node') {
+        args.push('--node');
+    }
+
+    const forwarded = Array.isArray(parsed.forwarded) ? parsed.forwarded : [];
+    for (let index = 0; index < forwarded.length; index += 1) {
+        const arg = forwarded[index];
+        if (!arg || arg === 'connect') {
+            continue;
+        }
+        if (arg === '--slot' || arg === '--manager' || arg === '--pair' || arg === '--auth-port') {
+            index += 1;
+            continue;
+        }
+        if (arg === '--login' || arg === '--logout' || arg === '--no-login' || arg === '--startup-run') {
+            continue;
+        }
+        args.push(arg);
+    }
+    args.push('--startup-run');
+    return args;
+}
+
+function registerWindowsStartup(startupArgs = []) {
+    if (!isWindowsStartupSupported()) {
+        return { changed: false, supported: false, path: '' };
+    }
+    const startupDir = getWindowsStartupDir();
+    const scriptPath = getWindowsStartupScriptPath();
+    const clientCommand = ['npx', '-y', '--prefer-online', 'livedesk@latest', 'client', ...startupArgs]
+        .filter(Boolean)
+        .map(quoteCommandArg)
+        .join(' ');
+    const runCommand = `cmd.exe /d /s /c "${clientCommand}"`;
+    const script = [
+        'Set shell = CreateObject("WScript.Shell")',
+        `shell.CurrentDirectory = "${escapeVbsString(os.homedir())}"`,
+        `shell.Run "${escapeVbsString(runCommand)}", 0, False`,
+        ''
+    ].join('\r\n');
+
+    mkdirSync(startupDir, { recursive: true });
+    writeFileSync(scriptPath, script, 'utf8');
+    rmSync(getLegacyWindowsStartupCommandPath(), { force: true });
+    return { changed: true, supported: true, path: scriptPath };
+}
+
+function unregisterWindowsStartup() {
+    if (!isWindowsStartupSupported()) {
+        return { changed: false, supported: false, path: '' };
+    }
+    const scriptPath = getWindowsStartupScriptPath();
+    const existed = existsSync(scriptPath) || existsSync(getLegacyWindowsStartupCommandPath());
+    rmSync(scriptPath, { force: true });
+    rmSync(getLegacyWindowsStartupCommandPath(), { force: true });
+    return { changed: existed, supported: true, path: scriptPath };
+}
+
+function normalizeStartupChoice(value, fallback = false) {
+    if (value === null || value === undefined) {
+        return Boolean(fallback);
+    }
+    return /^(1|true|yes|on)$/i.test(String(value).trim());
+}
+
+function applyStartupPreference(enabled, startupArgs = []) {
+    if (!isWindowsStartupSupported()) {
+        return { changed: false, supported: false, path: '' };
+    }
+    return enabled ? registerWindowsStartup(startupArgs) : unregisterWindowsStartup();
+}
+
 function createFileStorage(filePath) {
     function readState() {
         try {
@@ -428,12 +550,21 @@ function renderOAuthCallbackPage({ title, message, tone = 'neutral' }) {
 </html>`;
 }
 
-function renderConnectionChoicePage({ error = '', pin = '', slot = '' } = {}) {
+function renderConnectionChoicePage({ error = '', pin = '', slot = '', startup = false, startupSupported = false } = {}) {
     const errorBlock = error
         ? `<div class="error">${escapeHtml(error)}</div>`
         : '';
     const normalizedSlot = normalizeSlotNumber(slot);
     const slotLabel = normalizedSlot ? `Slot ${String(normalizedSlot).padStart(3, '0')}` : 'First available';
+    const startupBlock = startupSupported
+        ? `<label class="startup-option">
+            <input id="startup-toggle" type="checkbox" ${startup ? 'checked' : ''}>
+            <span>
+              <strong>Start with Windows</strong>
+              <small>Reconnect automatically after reboot.</small>
+            </span>
+          </label>`
+        : '';
     return `<!doctype html>
 <html lang="en">
 <head>
@@ -539,6 +670,39 @@ function renderConnectionChoicePage({ error = '', pin = '', slot = '' } = {}) {
       font-size: 13px;
       font-weight: 900;
     }
+    .startup-option {
+      display: grid;
+      grid-template-columns: 18px 1fr;
+      gap: 10px;
+      align-items: center;
+      padding: 11px 12px;
+      border: 1px solid #d9dee7;
+      border-radius: 8px;
+      background: #ffffff;
+      color: #111827;
+      cursor: pointer;
+      user-select: none;
+    }
+    .startup-option input {
+      width: 16px;
+      height: 16px;
+      margin: 0;
+      accent-color: #111827;
+    }
+    .startup-option span {
+      display: grid;
+      gap: 2px;
+    }
+    .startup-option strong {
+      font-size: 13px;
+      font-weight: 900;
+    }
+    .startup-option small {
+      color: #64748b;
+      text-align: left;
+      font-size: 12px;
+      font-weight: 700;
+    }
     form {
       display: grid;
       gap: 12px;
@@ -723,15 +887,20 @@ function renderConnectionChoicePage({ error = '', pin = '', slot = '' } = {}) {
         </div>
         ${errorBlock}
         <section class="panel">
-          <a class="google" href="/google">Continue with Google</a>
+          <form id="google-form" method="get" action="/google">
+            <input id="google-startup" type="hidden" name="startup" value="${startup ? '1' : '0'}">
+            <button class="google" type="submit">Continue with Google</button>
+          </form>
           <div class="divider">or</div>
-          <form method="post" action="/pin">
+          <form id="pin-form" method="post" action="/pin">
+            <input id="pin-startup" type="hidden" name="startup" value="${startup ? '1' : '0'}">
             <label>
               Hub PIN
               <input name="pin" value="${escapeHtml(pin)}" inputmode="numeric" autocomplete="one-time-code" pattern="[0-9]{6}" maxlength="6" placeholder="000000" autofocus>
             </label>
             <button type="submit">Connect with PIN</button>
           </form>
+          ${startupBlock}
           <div class="placement">
             <span>Placement</span>
             <strong>${escapeHtml(slotLabel)}</strong>
@@ -756,6 +925,21 @@ function renderConnectionChoicePage({ error = '', pin = '', slot = '' } = {}) {
       </div>
     </aside>
   </div>
+  <script>
+    const startupToggle = document.getElementById('startup-toggle');
+    const startupFields = [
+      document.getElementById('google-startup'),
+      document.getElementById('pin-startup')
+    ].filter(Boolean);
+    function syncStartupFields() {
+      const value = startupToggle && startupToggle.checked ? '1' : '0';
+      startupFields.forEach(field => { field.value = value; });
+    }
+    if (startupToggle) {
+      startupToggle.addEventListener('change', syncStartupFields);
+      syncStartupFields();
+    }
+  </script>
 </body>
 </html>`;
 }
@@ -820,6 +1004,8 @@ async function startConnectionChoiceServer(supabase, options = {}) {
     const host = String(process.env.LIVEDESK_CLIENT_AUTH_HOST || DEFAULT_AUTH_CALLBACK_HOST).trim() || DEFAULT_AUTH_CALLBACK_HOST;
     const port = normalizePort(options.authPort) || DEFAULT_AUTH_CALLBACK_PORT;
     const slot = normalizeSlotNumber(options.slot);
+    const startupArgs = Array.isArray(options.startupArgs) ? options.startupArgs : [];
+    let pendingStartup = isWindowsStartupRegistered();
     let listeningPort = port;
     let completed = false;
     let completedTitle = 'LiveDesk connection complete';
@@ -838,7 +1024,12 @@ async function startConnectionChoiceServer(supabase, options = {}) {
         settleChoice(choice);
         setImmediate(() => server.close());
     };
-    const renderChoice = (props = {}) => renderConnectionChoicePage({ slot, ...props });
+    const renderChoice = (props = {}) => renderConnectionChoicePage({
+        slot,
+        startup: pendingStartup,
+        startupSupported: isWindowsStartupSupported(),
+        ...props
+    });
 
     const handleError = (res, error, pin = '') => {
         res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
@@ -872,8 +1063,10 @@ async function startConnectionChoiceServer(supabase, options = {}) {
             }
 
             if (requestUrl.pathname === '/google') {
+                pendingStartup = normalizeStartupChoice(requestUrl.searchParams.get('startup'), pendingStartup);
                 const { data: existing } = await supabase.auth.getSession();
                 if (existing?.session?.access_token) {
+                    applyStartupPreference(pendingStartup, startupArgs);
                     res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
                     res.end(renderOAuthCallbackPage({
                         title: 'LiveDesk sign-in ready',
@@ -905,14 +1098,18 @@ async function startConnectionChoiceServer(supabase, options = {}) {
 
             if (requestUrl.pathname === '/pin') {
                 let pin = requestUrl.searchParams.get('pin') || '';
+                let startupValue = requestUrl.searchParams.get('startup');
                 if (req.method !== 'GET') {
                     const body = await readRequestBody(req);
                     const params = new URLSearchParams(body);
                     pin = params.get('pin') || pin;
+                    startupValue = params.get('startup');
                 }
+                pendingStartup = normalizeStartupChoice(startupValue, pendingStartup);
                 pin = normalizePairingPin(pin);
                 try {
                     const resolved = await resolveManagerFromPin(supabase, pin);
+                    applyStartupPreference(pendingStartup, startupArgs);
                     res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
                     res.end(renderOAuthCallbackPage({
                         title: 'LiveDesk PIN accepted',
@@ -961,6 +1158,7 @@ async function startConnectionChoiceServer(supabase, options = {}) {
                     server.close();
                     return;
                 }
+                applyStartupPreference(pendingStartup, startupArgs);
                 res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
                 res.end(renderOAuthCallbackPage({
                     title: 'LiveDesk sign-in complete',
@@ -1014,7 +1212,8 @@ async function startConnectionChoiceServer(supabase, options = {}) {
 async function chooseClientConnection(supabase, options = {}) {
     const connectionPage = await startConnectionChoiceServer(supabase, {
         authPort: options.authPort,
-        slot: options.slot
+        slot: options.slot,
+        startupArgs: options.startupArgs
     });
     console.log('Opening LiveDesk connection page...');
     openBrowser(connectionPage.url);
@@ -1145,10 +1344,15 @@ async function prepareLoginConnection(parsed) {
 
     if (shouldLogin) {
         const supabase = await createSupabaseClient();
-        const choice = await chooseClientConnection(supabase, {
-            authPort: parsed.authPort,
-            slot: parsed.slot
-        });
+        const startupArgs = buildStartupClientArgs(parsed);
+        const savedSession = parsed.startupRun ? await refreshSessionIfNeeded(supabase) : null;
+        const choice = savedSession?.access_token
+            ? { type: 'google', session: savedSession }
+            : await chooseClientConnection(supabase, {
+                authPort: parsed.authPort,
+                slot: parsed.slot,
+                startupArgs
+            });
         if (choice.type === 'pin') {
             manager = choice.manager;
             pair = choice.pair;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livedesk/client",
-  "version": "0.1.52",
+  "version": "0.1.53",
   "description": "LiveDesk local remote client",
   "type": "module",
   "bin": {