@volter/teams 0.2.33 → 0.2.35

package/http-client.mjs

@@ -28,7 +28,7 @@ export class TeamsClient {
     for(let attempt=0;attempt<5;attempt++) { try {
       const response=await this.fetch(this.server+path,{method,signal,redirect:'manual',headers:{Accept:'application/json',Authorization:`Bearer ${this.credential}`,...callerHeader(caller),...(body!==undefined?{'Content-Type':'application/json'}:{}),...(key?{'Idempotency-Key':key}:{}),...(ifMatch!==undefined?{'If-Match':String(ifMatch)}:{})},body:body===undefined?undefined:JSON.stringify(SIGN_IN.test(path)?body:redactValue(body))});
       if(response.type==='opaqueredirect'||(response.status>=300&&response.status<400))throw Object.assign(new Error('cross-origin redirects are refused'),{code:'invalid_request',status:400,retryable:false});
-      const value=response.status===204?null:await response.json();if(!response.ok)throw Object.assign(new Error(value?.error?.message??`HTTP ${response.status}`),value?.error,{status:response.status});return value;
+      const value=response.status===204?null:await response.json();if(!response.ok){const message=answerMessage(value?.error?.message??`HTTP ${response.status}`,response,value?.error);throw Object.assign(new Error(message),value?.error,{status:response.status,message});}return value;
     } catch(error) { last=error;if(method!=='GET'||signal?.aborted||!(!error.status||error.retryable)||attempt===4)throw error;await retryWait(delay,signal);delay=Math.min(delay*2,5000); } }
     throw last;
   }
@@ -230,12 +230,22 @@ async function* attachmentEvents(root, base, attachment, { signal } = {}) {
 }
 const query=q=>{const p=new URLSearchParams();for(const [k,v]of Object.entries(q))if(v!==undefined)p.set(k,String(v));return p.size?'?'+p:'';};
 const retryWait=(delay,signal)=>new Promise((resolve,reject)=>{const done=()=>{signal?.removeEventListener('abort',abort);resolve();},timer=setTimeout(done,delay),abort=()=>{clearTimeout(timer);signal?.removeEventListener('abort',abort);reject(signal.reason);};signal?.addEventListener('abort',abort,{once:true});});
-async function sseError(response){let value=null;try{value=await response.json();}catch{}return Object.assign(new Error(value?.error?.message??`SSE HTTP ${response.status}`),value?.error,{status:response.status,retryable:value?.error?.retryable??(response.status===429||response.status>=500),retryAfterMs:retryAfterMs(value?.error,response)});}
+// A server failure (5xx) says what the Worker's own log can be read by: its status, its request id and Cloudflare's
+// ray (2026-10-06: "Teams server is temporarily unavailable" with no way to tell which request, or why, failed).
+function answerMessage(message,response,error){
+  if(response.status<500)return message;
+  const ray=response.headers?.get?.('cf-ray');const id=error?.request_id??response.headers?.get?.('x-request-id');
+  return `${message} (HTTP ${response.status}${id?`, request ${id}`:''}${ray?`, cf-ray ${ray}`:''})`;
+}
+async function sseError(response){let value=null;try{value=await response.json();}catch{}const message=answerMessage(value?.error?.message??`SSE HTTP ${response.status}`,response,value?.error);return Object.assign(new Error(message),value?.error,{message,status:response.status,retryable:value?.error?.retryable??(response.status===429||response.status>=500),retryAfterMs:retryAfterMs(value?.error,response)});}
 // How long a refused stream waits before asking again: the server's retry_after (its body, else Retry-After), at least
 // 5 s; a refusal that names none waits 30 s. Null for an error that is not a refusal for load.
 export function retryAfterMs(error,response=null){
   if(typeof error?.retryAfterMs==='number')return error.retryAfterMs;
-  if(error?.code!=='rate_limited'&&response?.status!==429&&error?.status!==429)return null;
+  // a rate limit, or a 503 that says when to come back (Retry-After: the Teams Worker's own, 15 s when its object is
+  // overloaded): a refusal for load, waited out, never re-dialled into on a fixed backoff by every machine at once
+  const unavailable=(response?.status===503||error?.status===503)&&response?.headers?.get?.('retry-after');
+  if(error?.code!=='rate_limited'&&response?.status!==429&&error?.status!==429&&!unavailable)return null;
   const named=error?.details?.retry_after_seconds??error?.retry_after_seconds??response?.headers?.get?.('retry-after'),seconds=named==null||named===''?NaN:Number(named);
   return Math.max(5000,Number.isFinite(seconds)?seconds*1000:30000);
 }

package/machine-core.mjs

@@ -201,6 +201,16 @@ export class MachineCore extends EventEmitter {
         this.emit('link', { event: 'up', server });
       } catch (error) { socket.terminate(); dropped(error); }
     });
+    // A refused upgrade (a 503 from the Worker, a 429) says when to come back: its Retry-After is waited, at least,
+    // before the next dial, so every machine does not re-dial an overloaded server at 1/2/4/8 s (#1246 review).
+    socket.once('unexpected-response', (request, response) => {
+      const seconds = Number(response.headers?.['retry-after']);
+      if ([429, 503].includes(response.statusCode) && Number.isFinite(seconds) && seconds > 0) this.linkRetryAfter = Math.min(seconds * 1000, LINK_BACKOFF_MAX_MS * 4);
+      response.resume();
+      request.destroy();
+      dropped(new Error(`the server refused the link: HTTP ${response.statusCode}`));
+    });
+    socket.on('error', () => {}); // after a refused upgrade, its aborted request's error too
     socket.once('error', dropped);
     socket.once('close', (_code, reason) => {
       // The server keeps one link per machine and closes the older one as `replaced`: another
@@ -216,7 +226,8 @@ export class MachineCore extends EventEmitter {
 
   #retryLink() {
     if (this.stopping || !this.link || this.linkTimer || this.linkReplaced) return;
-    const delay = this.linkBackoff;
+    const delay = Math.max(this.linkBackoff, this.linkRetryAfter ?? 0);
+    this.linkRetryAfter = null;
     this.linkBackoff = Math.min(this.linkBackoff * 2, LINK_BACKOFF_MAX_MS);
     this.linkTimer = setTimeout(() => { this.linkTimer = null; this.#connectLink(); }, delay);
     this.linkTimer.unref?.();

package/package.json

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