MultiRoombaRover/webui/src/lib/interInstanceTransfer.js

// Inter-Instance Transfer Helpers
// Purpose: Builds cross-server links and optionally carries the local settings cookie when page settings allow it.
// Scope: Keeps URL encoding and settings-transfer behavior out of the rover queue rendering code.
import { loadSettings } from '../settings/persistence.js';

function base64UrlEncodeJson(value) {
  const json = JSON.stringify(value ?? {});
  const bytes = new TextEncoder().encode(json);
  let binary = '';
  bytes.forEach((byte) => {
    binary += String.fromCharCode(byte);
  });
  return btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/g, '');
}

export function base64UrlDecodeJson(value) {
  const raw = String(value || '').replace(/-/g, '+').replace(/_/g, '/');
  const padded = raw.padEnd(Math.ceil(raw.length / 4) * 4, '=');
  const binary = atob(padded);
  const bytes = Uint8Array.from(binary, (char) => char.charCodeAt(0));
  return JSON.parse(new TextDecoder().decode(bytes));
}

export function buildExternalRoverUrl(instance, roverId, { includeSettings = false } = {}) {
  const publicUrl = String(instance?.instance?.publicUrl || instance?.publicUrl || instance?.url || '').trim();
  if (!publicUrl) return '';
  const url = new URL(publicUrl);
  if (roverId) url.searchParams.set('rover', String(roverId));
  /*
    The destination always applies settingsTransfer if present. Whether this
    source page includes the payload is controlled by the persistent Page
    settings toggle, so cross-server navigation does not need a per-click popup.
  */
  if (includeSettings) {
    url.searchParams.set('settingsTransfer', base64UrlEncodeJson(loadSettings()));
  }
  return url.toString();
}

export function openExternalRover(instance, roverId, { includeSettings = true } = {}) {
  const targetUrl = buildExternalRoverUrl(instance, roverId, { includeSettings });
  if (!targetUrl) return;
  window.location.href = targetUrl;
}