Errors & limits

try {
  await window.vos.fs.writeFile(dir, "notes.json", payload);
} catch (err) {
  // err is a standard Error.
  // err.message  → a human-readable description from the host
  // err.name     → "Error"
  // err.code     → undefined (see the caveat below)
  console.warn(err.message);
}

// Classify by message, with a generic fallback you are happy to show.
function classify(err) {
  const m = (err && err.message ? err.message : "").toLowerCase();
  if (m.includes("permission") || m.includes("access denied")) return "permission";
  if (m.includes("sign in") || m.includes("auth")) return "auth";
  if (m.includes("upgrade") || m.includes("plan")) return "upgrade";
  if (m.includes("quota") || m.includes("credit")) return "quota";
  if (m.includes("rate limit")) return "rate";
  if (m.includes("timed out") || m.includes("timeout")) return "timeout";
  if (m.includes("too large")) return "size";
  return "unknown";
}

// Never let one failed call take down the whole app.
async function safe(label, fn, fallback) {
  try {
    return await fn();
  } catch (err) {
    console.warn(label + " failed:", err.message);
    setStatus(friendlyMessage(classify(err)));
    return fallback;
  }
}

const settings = await safe("load settings", () => loadSettings(), DEFAULT_SETTINGS);

// Every SDK call rejects after 30s. For long jobs, work in chunks
// and keep the user informed between them.
async function saveAll(files) {
  for (let i = 0; i < files.length; i++) {
    setStatus("Saving " + (i + 1) + " of " + files.length + "…");
    await window.vos.fs.writeFile(files[i].dir, files[i].name, files[i].body);
  }
  setStatus("Saved");
}

// A boot sequence that degrades instead of showing a blank window.
async function boot() {
  let info = null;
  try {
    info = await window.vos.app.getInfo();
  } catch (err) {
    // The SDK exists but the host did not answer — show the UI read-only.
    renderShell({ readOnly: true, notice: "Storage unavailable" });
    return;
  }

  renderShell({ readOnly: !info.permissions.hasWrite });
  if (info.permissions.hasWrite) await loadDocuments(info.sandboxPath);
}