@volter/teams 0.1.70 → 0.1.72

package/browser-channel.d.ts

@@ -49,8 +49,10 @@ export type BrowserTurnAnswer =
 /**
  * One line typed into the channel's session as its user's own turn; rejects when the machine refuses the stream.
  * `turnKey`: one per typed line, reused on retry, so the machine types the line once.
+ * Receipt waits time out after thirty seconds. Cancellation stops waiting; it
+ * does not undo delivery. Reuse the same key when retrying an uncertain receipt.
  */
-export function sendBrowserTurn(channel: BrowserChannel, text: string, options?: { turnKey?: string }): Promise<BrowserTurnAnswer>;
+export function sendBrowserTurn(channel: BrowserChannel, text: string, options?: { turnKey?: string; signal?: AbortSignal }): Promise<BrowserTurnAnswer>;
 
 export interface MailHistoryEntry {
   id: string; from: string; fromName: string; to: string; text: string; at: number;

package/browser-channel.mjs

@@ -173,13 +173,33 @@ export function openBrowserSession({ origin, teamId, sessionId, token }, { WebSo
  * is free), or `{ code, text }` when it was not delivered; rejects when the machine refuses the stream.
  * `turnKey`: one key per line the person typed, reused when they retry it, so a line the machine took after its
  * first send was given up on is not typed twice (a machine of door vocabulary 3 or later keeps each key once).
+ * Receipt waits are bounded to thirty seconds and 256 KB. `signal` cancels the
+ * wait; neither cancellation nor timeout undoes a turn already accepted.
  */
-export async function sendBrowserTurn(channel, text, { turnKey } = {}) {
+export async function sendBrowserTurn(channel, text, { turnKey, signal } = {}) {
+  signal?.throwIfAborted();
   const stream = await channel.open('mail', { request: { op: 'turn', text, ...(turnKey ? { turn_key: String(turnKey) } : {}) } });
-  return new Promise((resolve) => {
-    let answer = '';
-    stream.on('data', (chunk) => { answer += chunk; });
-    stream.on('close', () => { try { resolve(JSON.parse(answer)); } catch { resolve({ code: 1, text: answer || 'no answer from the machine' }); } });
+  return new Promise((resolve, reject) => {
+    let answer = '', settled = false;
+    const cleanup = () => { clearTimeout(timer); stream.off('data', data); stream.off('close', closed); signal?.removeEventListener('abort', cancelled); };
+    const fail = error => {
+      if (settled) return;
+      settled = true; cleanup(); reject(error);
+      // close emits synchronously. A failed wait must not parse an incomplete
+      // receipt as success, or imply that a typed turn was rolled back.
+      stream.close(error.message);
+    };
+    const cancelled = () => fail(Object.assign(new Error('Turn delivery wait cancelled'), { name: 'AbortError' }));
+    const timer = setTimeout(() => fail(new Error('Turn delivery acknowledgement timed out')), 30_000);
+    const data = chunk => { answer += chunk; if (answer.length > 256_000) fail(new Error('Turn delivery receipt too large')); };
+    const closed = () => {
+      if (settled) return;
+      settled = true; cleanup();
+      try { resolve(JSON.parse(answer)); } catch { resolve({ code: 1, text: answer || 'no answer from the machine' }); }
+    };
+    stream.on('data', data);
+    if (!settled) stream.on('close', closed);
+    if (!settled && signal) { signal.addEventListener('abort', cancelled, { once: true }); if (signal.aborted) cancelled(); }
   });
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/teams",
-  "version": "0.1.70",
+  "version": "0.1.72",
   "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",