@djangocfg/widget-assistant 0.2.9 → 0.3.7

package/src/wire/transport.ts

@@ -2,7 +2,7 @@ import { decodeFrame, IDLE_MS, type ChatContext, type Frame } from './frames';
 import { parseSSE, StreamLostError } from './parseSSE';
 
 /** Problem codes the API answers before a stream starts (CONTRACT.md "Auth and errors"). */
-export type RejectCode = 'unauthorized' | 'busy' | 'invalid' | 'rate_limited' | 'unavailable' | 'failed';
+export type RejectCode = 'unauthorized' | 'busy' | 'invalid' | 'rate_limited' | 'unavailable' | 'not_found' | 'failed';
 
 /** The request was refused before any frame: nothing ran, so a retry with the same `client_id` is safe. */
 export class ChatHttpError extends Error {
@@ -19,6 +19,13 @@ export class ChatHttpError extends Error {
   }
 }
 
+/** The session is not there (never was, or it is someone else's: the API answers both with a 404). The host forgets the remembered id. */
+export class ThreadNotFoundError extends Error {
+  constructor() {
+    super('chat thread not found');
+  }
+}
+
 /** No answer at all (offline, DNS, reset before the response): nothing is known to have run. */
 export class ChatNetworkError extends Error {
   constructor() {
@@ -27,6 +34,8 @@ export class ChatNetworkError extends Error {
 }
 
 export interface SendInput {
+  /** The session this message goes to (set by the session layer; read by `streamUrl`). Absent for an anonymous host. */
+  threadId?: string;
   text: string;
   clientId: string;
   context?: ChatContext;
@@ -41,7 +50,7 @@ export interface ChatTransport {
 export interface TransportConfig {
   /** API origin, no trailing slash; prefixes a relative `streamUrl`. The stream is called directly, never through a Next rewrite. */
   baseUrl: string;
-  /** Where one run is opened: a path or URL, or a function read per request (a thread id in the path). Absent: the legacy `/apix/chat/v1/stream` (deprecated, removed in 0.3). */
+  /** Where one run is opened: a path or URL, or a function read per request (a thread id in the path). Absent: the legacy `/apix/chat/v1/stream` (anonymous hosts only; a signed-in host with sessions always sets this). */
   streamUrl?: string | ((input: SendInput) => string);
   /** The request body. Absent: `{text, client_id, context?}`. */
   buildBody?: (input: SendInput) => unknown;
@@ -58,7 +67,7 @@ export interface TransportConfig {
   fetch?: typeof fetch;
 }
 
-const CODES: readonly string[] = ['unauthorized', 'busy', 'invalid', 'rate_limited', 'unavailable'];
+const CODES: readonly string[] = ['unauthorized', 'busy', 'invalid', 'rate_limited', 'unavailable', 'not_found'];
 /** A server may name a bad request its own way; these read as `invalid`. */
 const INVALID: readonly string[] = ['validation_error'];
 
@@ -67,6 +76,7 @@ function rejectCode(status: number, body: unknown): RejectCode {
   if (typeof code === 'string' && CODES.includes(code)) return code as RejectCode;
   if (typeof code === 'string' && INVALID.includes(code)) return 'invalid';
   if (status === 401) return 'unauthorized';
+  if (status === 404) return 'not_found';
   if (status === 409) return 'busy';
   if (status === 400 || status === 422) return 'invalid';
   if (status === 429) return 'rate_limited';