@volter/teams 0.1.33 → 0.1.34

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/teams",
-  "version": "0.1.33",
+  "version": "0.1.34",
   "type": "module",
   "description": "Volter Teams, the neutral team plane: machine identity and daemon core, the local door and server link, admission from machine grants, product doors, and the Teams server's neutral routes (company RFC 0008).",
   "license": "MIT",

package/viewer/viewer.mjs

@@ -17,6 +17,20 @@ let waiting = null;
 
 const embedded = window.parent !== window;
 const ask = (type) => { if (embedded) window.parent.postMessage({ type }, '*'); };
+// Where a failure is reported: the session this page shows, once it knows it (the server logs it under the token's member).
+let reportTo = null;
+/**
+ * A failure this page cannot recover from by itself (a read, the follow, the page's own code): shown as a plain line,
+ * posted to the host as `viewer-error` { stage, status, message }, and sent to the server's log.
+ */
+function failed(stage, error, statusCode = null) {
+  const message = String(error?.message ?? error ?? 'unknown error').slice(0, 400);
+  status(message);
+  if (embedded) window.parent.postMessage({ type: 'viewer-error', stage, status: statusCode, message }, '*');
+  if (reportTo && token) fetch(reportTo, { method: 'POST', keepalive: true, headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ stage, status: statusCode, message }) }).catch(() => {});
+}
+window.addEventListener('error', (event) => failed('page', event.error ?? event.message));
+window.addEventListener('unhandledrejection', (event) => failed('page', event.reason));
 // The host's style, as supercode-ui is themed: its `--volter-*` brand tokens and `--scui-*` component tokens, set on
 // the session's root (every component reads them from an ancestor). Nothing else is taken from the host.
 function applyTheme(properties) {
@@ -120,8 +134,9 @@ async function showSession(session, control) {
   stylesheet.rel = 'stylesheet';
   stylesheet.href = '/view/session-view.css';
   document.head.append(stylesheet);
-  const { mountSessionView } = await import('/view/session-view.mjs');
   const base = `${location.origin}/api/v1/teams/${encodeURIComponent(session.team)}/sessions/${encodeURIComponent(session.id)}`;
+  reportTo = `${base}/viewer-errors`;
+  const { mountSessionView } = await import('/view/session-view.mjs').catch((error) => { throw Object.assign(error, { stage: 'load' }); });
   const element = $('session');
   element.hidden = false;
   const view = mountSessionView(element, {
@@ -159,7 +174,7 @@ async function showSession(session, control) {
   const read = () => (reading ??= (async () => {
     try {
       const response = await fetch(`${base}/messages?tail=300`, { headers: await headers() });
-      if (!response.ok) throw new Error(`reading the session failed (${response.status})`);
+      if (!response.ok) throw Object.assign(new Error(`reading the session failed (${response.status})`), { stage: 'read', status: response.status });
       const body = await response.json();
       apply(body);
       return body;
@@ -173,7 +188,7 @@ async function showSession(session, control) {
     try {
       if (!cursor) cursor = String((await read()).event_cursor ?? '') || null;
       const response = await fetch(`${base}/events?${cursor ? `after=${encodeURIComponent(cursor)}` : 'tail=1'}`, { headers: await headers() });
-      if (!response.ok) throw new Error(`following the session failed (${response.status})`);
+      if (!response.ok) throw Object.assign(new Error(`following the session failed (${response.status})`), { stage: 'follow', status: response.status });
       view.update({ live: true });
       status('');
       const reader = response.body.getReader();
@@ -193,12 +208,14 @@ async function showSession(session, control) {
           // The server ends a stream it can no longer resume (a slow reader, a retired cursor): start from a snapshot.
           if (event.terminal && event.type === 'resync_required') cursor = null;
           if (event.type === 'snapshot') apply(event.data);
-          else if (event.type === 'session_changed') read().catch((error) => status(error.message));
+          else if (event.type === 'session_changed') read().catch((error) => failed('read', error, error.status ?? null));
           else if (event.type === 'session_deleted') { view.update({ live: false, status: 'error', error: 'This session was deleted.' }); return; }
         }
       }
     } catch (error) {
-      status(error.message);
+      failed(error.stage ?? 'follow', error, error.status ?? null);
+      // Nothing drawn yet: the transcript says why instead of loading forever.
+      if (!cursor) view.update({ status: 'error', error: error.message });
     }
     view.update({ live: false });
     await new Promise((resolve) => setTimeout(resolve, 2000));
@@ -320,4 +337,4 @@ async function showFolder(connect, root, control) {
   await list(base);
 }
 
-main().catch((error) => status(error.message));
+main().catch((error) => failed(error?.stage ?? 'start', error, error?.status ?? null));