@cf-vibesdk/sdk 0.0.2 → 0.0.3

package/README.md

@@ -1,6 +1,6 @@
 # @cf-vibesdk/sdk
 
-Type-safe client SDK for the VibeSDK platform.
+Client SDK for the VibeSDK platform.
 
 ## Install
 

package/dist/index.d.ts

@@ -1326,6 +1326,12 @@ export interface AgentConnectionData {
 	agentId: string;
 }
 export type AgentPreviewResponse = PreviewType;
+type RetryConfig = {
+	enabled?: boolean;
+	initialDelayMs?: number;
+	maxDelayMs?: number;
+	maxRetries?: number;
+};
 type BehaviorType$1 = BehaviorType;
 type ProjectType$1 = ProjectType;
 export type Credentials = NonNullable<CodeGenArgs["credentials"]>;
@@ -1525,6 +1531,8 @@ export type VibeClientOptions = {
 	/** Optional WebSocket factory for Node/Bun runtimes. */
 	webSocketFactory?: AgentConnectionOptions["webSocketFactory"];
 	fetchFn?: typeof fetch;
+	/** HTTP retry configuration for transient failures (5xx, network errors). */
+	retry?: RetryConfig;
 };
 type GenerationState = {
 	status: "idle";
@@ -1593,6 +1601,7 @@ export declare class SessionStateStore {
 	onChange(cb: (next: SessionState, prev: SessionState) => void): () => void;
 	applyWsMessage(msg: AgentWsServerMessage): void;
 	private setState;
+	clear(): void;
 }
 type WorkspaceChange = {
 	type: "reset";
@@ -1616,6 +1625,7 @@ export declare class WorkspaceStore {
 	/** Apply a single file upsert from WS file events. */
 	applyFileUpsert(file: unknown): void;
 	applyWsMessage(msg: AgentWsServerMessage): void;
+	clear(): void;
 }
 type WaitUntilReadyOptions = WaitOptions;
 type BuildSessionConnectOptions = AgentConnectionOptions & {

package/dist/index.js

@@ -1,10 +1,40 @@
 // @bun
+// src/retry.ts
+function normalizeRetryConfig(retry, defaults) {
+  return {
+    enabled: retry?.enabled ?? defaults.enabled,
+    initialDelayMs: retry?.initialDelayMs ?? defaults.initialDelayMs,
+    maxDelayMs: retry?.maxDelayMs ?? defaults.maxDelayMs,
+    maxRetries: retry?.maxRetries ?? defaults.maxRetries
+  };
+}
+function computeBackoffMs(attempt, cfg) {
+  const base = Math.min(cfg.maxDelayMs, cfg.initialDelayMs * Math.pow(2, Math.max(0, attempt)));
+  const jitter = base * 0.2;
+  return Math.max(0, Math.floor(base - jitter + Math.random() * jitter * 2));
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
 // src/http.ts
+var HTTP_RETRY_DEFAULTS = {
+  enabled: true,
+  initialDelayMs: 1000,
+  maxDelayMs: 1e4,
+  maxRetries: 3
+};
+function isRetryableStatus(status) {
+  return status >= 500 && status < 600;
+}
+
 class HttpClient {
   opts;
   cachedAccessToken = null;
+  retryCfg;
   constructor(opts) {
     this.opts = opts;
+    this.retryCfg = normalizeRetryConfig(opts.retry, HTTP_RETRY_DEFAULTS);
   }
   get baseUrl() {
     return this.opts.baseUrl.replace(/\/$/, "");
@@ -34,7 +64,7 @@ class HttpClient {
       }
     });
     if (!resp.ok) {
-      const text = await resp.text().catch(() => "");
+      const text = (await resp.text().catch(() => "")).slice(0, 1000);
       if (resp.status === 401) {
         throw new Error(`HTTP 401 for /api/auth/exchange-api-key: invalid API key (regenerate in Settings \u2192 API Keys). ${text || ""}`.trim());
       }
@@ -60,21 +90,59 @@ class HttpClient {
   }
   async fetchJson(path, init) {
     const url = `${this.baseUrl}${path}`;
-    const resp = await this.fetchFn(url, init);
-    if (!resp.ok) {
-      const text = await resp.text().catch(() => "");
-      throw new Error(`HTTP ${resp.status} for ${path}: ${text || resp.statusText}`);
+    let lastError = null;
+    for (let attempt = 0;attempt <= this.retryCfg.maxRetries; attempt++) {
+      try {
+        const resp = await this.fetchFn(url, init);
+        if (!resp.ok) {
+          const text = (await resp.text().catch(() => "")).slice(0, 1000);
+          const error = new Error(`HTTP ${resp.status} for ${path}: ${text || resp.statusText}`);
+          if (this.retryCfg.enabled && isRetryableStatus(resp.status) && attempt < this.retryCfg.maxRetries) {
+            lastError = error;
+            await sleep(computeBackoffMs(attempt, this.retryCfg));
+            continue;
+          }
+          throw error;
+        }
+        return await resp.json();
+      } catch (error) {
+        if (error instanceof TypeError && this.retryCfg.enabled && attempt < this.retryCfg.maxRetries) {
+          lastError = error;
+          await sleep(computeBackoffMs(attempt, this.retryCfg));
+          continue;
+        }
+        throw error;
+      }
     }
-    return await resp.json();
+    throw lastError ?? new Error(`Failed after ${this.retryCfg.maxRetries} retries`);
   }
   async fetchRaw(path, init) {
     const url = `${this.baseUrl}${path}`;
-    const resp = await this.fetchFn(url, init);
-    if (!resp.ok) {
-      const text = await resp.text().catch(() => "");
-      throw new Error(`HTTP ${resp.status} for ${path}: ${text || resp.statusText}`);
+    let lastError = null;
+    for (let attempt = 0;attempt <= this.retryCfg.maxRetries; attempt++) {
+      try {
+        const resp = await this.fetchFn(url, init);
+        if (!resp.ok) {
+          const text = (await resp.text().catch(() => "")).slice(0, 1000);
+          const error = new Error(`HTTP ${resp.status} for ${path}: ${text || resp.statusText}`);
+          if (this.retryCfg.enabled && isRetryableStatus(resp.status) && attempt < this.retryCfg.maxRetries) {
+            lastError = error;
+            await sleep(computeBackoffMs(attempt, this.retryCfg));
+            continue;
+          }
+          throw error;
+        }
+        return resp;
+      } catch (error) {
+        if (error instanceof TypeError && this.retryCfg.enabled && attempt < this.retryCfg.maxRetries) {
+          lastError = error;
+          await sleep(computeBackoffMs(attempt, this.retryCfg));
+          continue;
+        }
+        throw error;
+      }
     }
-    return resp;
+    throw lastError ?? new Error(`Failed after ${this.retryCfg.maxRetries} retries`);
   }
 }
 
@@ -137,6 +205,10 @@ class TypedEmitter {
     for (const cb of set)
       cb(payload);
   }
+  clear() {
+    this.listeners.clear();
+    this.anyListeners.clear();
+  }
 }
 
 // src/state.ts
@@ -147,9 +219,10 @@ var INITIAL_STATE = {
   cloudflare: { status: "idle" }
 };
 function extractPhaseInfo(msg) {
+  const phase = msg?.phase;
   return {
-    name: msg.phase?.name,
-    description: msg.phase?.description
+    name: phase?.name,
+    description: phase?.description
   };
 }
 
@@ -299,6 +372,10 @@ class SessionStateStore {
     this.state = next;
     this.emitter.emit("change", { prev, next });
   }
+  clear() {
+    this.state = INITIAL_STATE;
+    this.emitter.clear();
+  }
 }
 
 // src/ws.ts
@@ -308,23 +385,15 @@ function toWsCloseEvent(ev) {
     reason: typeof ev.reason === "string" ? ev.reason : ""
   };
 }
-function normalizeRetryConfig(retry) {
-  const enabled = retry?.enabled ?? true;
-  return {
-    enabled,
-    initialDelayMs: retry?.initialDelayMs ?? 1000,
-    maxDelayMs: retry?.maxDelayMs ?? 30000,
-    maxRetries: retry?.maxRetries ?? Infinity
-  };
-}
-function computeBackoffMs(attempt, cfg) {
-  const base = Math.min(cfg.maxDelayMs, cfg.initialDelayMs * Math.pow(2, Math.max(0, attempt)));
-  const jitter = base * 0.2;
-  return Math.max(0, Math.floor(base - jitter + Math.random() * jitter * 2));
-}
+var WS_RETRY_DEFAULTS = {
+  enabled: true,
+  initialDelayMs: 1000,
+  maxDelayMs: 30000,
+  maxRetries: Infinity
+};
 function createAgentConnection(url, options = {}) {
   const emitter = new TypedEmitter;
-  const retryCfg = normalizeRetryConfig(options.retry);
+  const retryCfg = normalizeRetryConfig(options.retry, WS_RETRY_DEFAULTS);
   const headers = { ...options.headers ?? {} };
   if (options.origin)
     headers.Origin = options.origin;
@@ -501,7 +570,7 @@ function createAgentConnection(url, options = {}) {
     }
     if (ws.on) {
       ws.on("open", () => onOpen());
-      ws.on("close", (code, reason) => onClose({ code, reason }));
+      ws.on("close", (code, reason) => onClose({ code: typeof code === "number" ? code : undefined, reason: typeof reason === "string" ? reason : undefined }));
       ws.on("error", (error) => onError(error));
       ws.on("message", (data) => onMessage(data));
     }
@@ -514,8 +583,12 @@ function createAgentConnection(url, options = {}) {
       return;
     }
     pendingSends.push(data);
-    if (pendingSends.length > maxPendingSends)
+    if (pendingSends.length > maxPendingSends) {
       pendingSends.shift();
+      emitter.emit("ws:error", {
+        error: new Error(`Message queue overflow: dropped oldest message (queue size: ${maxPendingSends})`)
+      });
+    }
   }
   function close() {
     closedByUser = true;
@@ -553,25 +626,24 @@ function createAgentConnection(url, options = {}) {
 function isRecord(value) {
   return typeof value === "object" && value !== null;
 }
+function isFileOutputType(value) {
+  if (!isRecord(value))
+    return false;
+  return typeof value.filePath === "string" && typeof value.fileContents === "string";
+}
 function extractGeneratedFilesFromState(state) {
   const out = [];
   for (const file of Object.values(state.generatedFilesMap ?? {})) {
-    const path = file.filePath;
-    const content = file.fileContents;
-    if (typeof path === "string" && typeof content === "string") {
-      out.push({ path, content });
-    }
+    if (!isFileOutputType(file))
+      continue;
+    out.push({ path: file.filePath, content: file.fileContents });
   }
   return out;
 }
 function extractGeneratedFileFromMessageFile(file) {
-  if (!isRecord(file))
-    return null;
-  const path = file.filePath;
-  const content = file.fileContents;
-  if (typeof path !== "string" || typeof content !== "string")
+  if (!isFileOutputType(file))
     return null;
-  return { path, content };
+  return { path: file.filePath, content: file.fileContents };
 }
 
 class WorkspaceStore {
@@ -624,6 +696,10 @@ class WorkspaceStore {
         break;
     }
   }
+  clear() {
+    this.files.clear();
+    this.emitter.clear();
+  }
 }
 
 // src/session.ts
@@ -843,6 +919,8 @@ class BuildSession {
   close() {
     this.connection?.close();
     this.connection = null;
+    this.workspace.clear();
+    this.state.clear();
   }
   assertConnected() {
     if (!this.connection) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cf-vibesdk/sdk",
-	"version": "0.0.2",
+	"version": "0.0.3",
 	"type": "module",
 	"exports": {
 		".": {