@bugbug-io/sdk 14.5.0 → 14.6.0

package/dist/index.d.ts

@@ -49,6 +49,7 @@ export declare function createBugBug(config: BugBugConfig): BugBugSDK;
 export { BugBugSDK } from './sdk';
 export type { BugBugConfig, RequestOptions, WaitOptions, RequestHook, RequestErrorHook, } from './types/config';
 export type { RateLimitConfig } from './services/rateLimiter/rateLimiter.types';
+export { RateLimiter } from './services/rateLimiter/rateLimiter';
 export { TestsModule } from './modules/tests/tests';
 export type { ImportTestOptions, ListTestRunsOptions, ListTestsOptions, RunTestBaseOptions, RunTestNoWatchProgressOptions, RunTestWatchProgressOptions, } from './modules/tests/tests.types';
 export { SuitesModule } from './modules/suites/suites';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -9596,7 +9596,7 @@ var buildUserAgent = (clientType, version) => `BugBug ${clientType.toUpperCase()
 // ../core/package.json
 var package_default = {
   name: "@bugbug-io/core",
-  version: "14.5.0",
+  version: "14.6.0",
   private: true,
   type: "module",
   main: "dist/index.js",
@@ -9831,12 +9831,15 @@ var RATE_LIMIT_MAX_WINDOW_MS = 6e4;
 // src/services/rateLimiter/rateLimiter.ts
 var RateLimiter = class {
   #requests = [];
+  #activeRequests = 0;
+  #slotQueue = [];
   #config;
   constructor(config) {
     this.#warnIfUnsupportedConfig(config);
     this.#config = {
       maxRequests: config.maxRequests,
       windowMs: config.windowMs,
+      maxConcurrentRequests: config.maxConcurrentRequests ?? Number.POSITIVE_INFINITY,
       retryAfter: config.retryAfter || 1e3,
       retryServer429: config.retryServer429 ?? true,
       exponentialBackoff: {
@@ -9874,51 +9877,67 @@ var RateLimiter = class {
    * @throws {RateLimitError} When retries are exhausted or `retryServer429` is
    *   disabled and the server returned 429.
    */
-  async execute(fn) {
+  async execute(fn, options = {}) {
+    const retryServer429 = options.retryServer429 ?? this.#config.retryServer429;
     let lastError = null;
-    for (let attempt = 0; attempt <= this.#config.exponentialBackoff.maxRetries; attempt++) {
-      if (!this.#canMakeRequest()) {
-        const waitTime = this.#getWaitTime();
-        const gateError = new RateLimitError(
-          waitTime,
-          `Rate limit exceeded. Wait ${waitTime}ms before retrying.`
-        );
-        lastError = gateError;
-        if (attempt === this.#config.exponentialBackoff.maxRetries) {
-          throw gateError;
-        }
-        await this.#sleep(this.#computeBackoff(attempt, gateError.retryAfter));
-        continue;
-      }
-      const stamp = this.#recordRequest();
-      try {
-        return await fn();
-      } catch (fnError) {
-        this.#releaseRequest(stamp);
-        if (!(fnError instanceof RateLimitError)) {
-          throw fnError;
-        }
-        lastError = fnError;
-        if (!this.#config.retryServer429) {
-          throw fnError;
+    await this.#acquireSlot();
+    try {
+      for (let attempt = 0; attempt <= this.#config.exponentialBackoff.maxRetries; attempt++) {
+        if (!this.#canMakeRequest()) {
+          const waitTime = this.#getWaitTime();
+          const gateError = new RateLimitError(
+            waitTime,
+            `Rate limit exceeded. Wait ${waitTime}ms before retrying.`
+          );
+          lastError = gateError;
+          if (attempt === this.#config.exponentialBackoff.maxRetries) {
+            throw gateError;
+          }
+          await this.#sleep(this.#computeBackoff(attempt, gateError.retryAfter));
+          continue;
         }
-        if (attempt === this.#config.exponentialBackoff.maxRetries) {
-          throw fnError;
+        const stamp = this.#recordRequest();
+        try {
+          return await fn();
+        } catch (fnError) {
+          this.#releaseRequest(stamp);
+          if (!(fnError instanceof RateLimitError)) {
+            throw fnError;
+          }
+          lastError = fnError;
+          if (!retryServer429) {
+            throw fnError;
+          }
+          if (attempt === this.#config.exponentialBackoff.maxRetries) {
+            throw fnError;
+          }
+          await this.#sleep(this.#computeBackoff(attempt, fnError.retryAfter));
         }
-        await this.#sleep(this.#computeBackoff(attempt, fnError.retryAfter));
       }
+      throw lastError || new Error("Max retries exceeded");
+    } finally {
+      this.#releaseSlot();
     }
-    throw lastError || new Error("Max retries exceeded");
   }
   #computeBackoff = (attempt, retryAfter) => {
-    const baseDelay = retryAfter || this.#config.exponentialBackoff.baseDelay;
-    const delay = Math.min(
-      baseDelay * Math.pow(2, attempt),
-      this.#config.exponentialBackoff.maxDelay
-    );
+    const baseDelay = retryAfter ?? this.#config.exponentialBackoff.baseDelay;
+    const computedDelay = baseDelay * Math.pow(2, attempt);
+    const delay = retryAfter !== void 0 ? Math.max(retryAfter, computedDelay) : Math.min(computedDelay, this.#config.exponentialBackoff.maxDelay);
     const jitter = Math.random() * 0.1 * delay;
     return delay + jitter;
   };
+  async #acquireSlot() {
+    while (this.#activeRequests >= this.#config.maxConcurrentRequests) {
+      await new Promise((resolve4) => {
+        this.#slotQueue.push(resolve4);
+      });
+    }
+    this.#activeRequests++;
+  }
+  #releaseSlot() {
+    this.#activeRequests = Math.max(0, this.#activeRequests - 1);
+    this.#slotQueue.shift()?.();
+  }
   /**
    * Sleep utility
    */
@@ -10127,6 +10146,16 @@ var BugBugApiClient = class {
     const resolved = resolveEnvConfig({
       overrides: { token: config.apiToken, apiUrl: config.apiUrl, projectId: config.projectId }
     });
+    const rateLimit = config.rateLimit || {
+      maxRequests: 100,
+      windowMs: 6e4,
+      exponentialBackoff: {
+        baseDelay: 1e3,
+        maxDelay: 3e4,
+        maxRetries: 3
+      }
+    };
+    const rateLimiter = config.rateLimiter ?? new RateLimiter(rateLimit);
     this.#config = {
       apiToken: resolved.token ?? "",
       projectId: resolved.projectId ?? "",
@@ -10135,15 +10164,7 @@ var BugBugApiClient = class {
       verbose: config.verbose || false,
       logLevel: config.logLevel || "info",
       timeout: config.timeout || 3e4,
-      rateLimit: config.rateLimit || {
-        maxRequests: 100,
-        windowMs: 6e4,
-        exponentialBackoff: {
-          baseDelay: 1e3,
-          maxDelay: 3e4,
-          maxRetries: 3
-        }
-      },
+      rateLimit,
       requestHeaders: {
         "User-Agent": buildUserAgent("sdk", getVersion()),
         ...config.requestHeaders
@@ -10153,11 +10174,12 @@ var BugBugApiClient = class {
       onAfterRequest: config.onAfterRequest || (() => {
       }),
       onRequestError: config.onRequestError || (() => {
-      })
+      }),
+      rateLimiter
     };
     this.#validateConfig();
     this.#client = this.#createApiClient();
-    this.#rateLimiter = new RateLimiter(this.#config.rateLimit);
+    this.#rateLimiter = rateLimiter;
   }
   #createApiClient = () => createClient({
     baseUrl: this.#config.apiUrl,
@@ -10237,71 +10259,75 @@ var BugBugApiClient = class {
       headers: customHeaders
     };
     this.#config.onBeforeRequest(requestData);
-    return this.#rateLimiter.execute(async () => {
-      const abortContext = this.#createAbortContext(signal, timeout);
-      try {
-        if (this.#config.verbose) {
-          this.#log("debug", `\u2192 ${method} ${path}`, { params, body });
-        }
-        const requestOptions = {
-          signal: abortContext.signal,
-          headers: {
-            ...customHeaders,
-            ...this.#identityHeaders()
+    return this.#rateLimiter.execute(
+      async () => {
+        const abortContext = this.#createAbortContext(signal, timeout);
+        try {
+          this.#throwIfAlreadyAborted(abortContext, requestOrigin);
+          if (this.#config.verbose) {
+            this.#log("debug", `\u2192 ${method} ${path}`, { params, body });
           }
-        };
-        if (scopedParams) {
-          requestOptions.params = scopedParams;
-        }
-        if (body !== void 0) {
-          requestOptions.body = body;
-        }
-        let response;
-        switch (method) {
-          case "GET":
-            response = await this.#client.GET(path, requestOptions);
-            break;
-          case "POST":
-            response = await this.#client.POST(path, requestOptions);
-            break;
-          case "PUT":
-            response = await this.#client.PUT(path, requestOptions);
-            break;
-          case "DELETE":
-            response = await this.#client.DELETE(path, requestOptions);
-            break;
-          case "PATCH":
-            response = await this.#client.PATCH(path, requestOptions);
-            break;
-          default:
-            throw new ValidationError(`Unsupported HTTP method: ${method}`);
-        }
-        abortContext.clear();
-        if (this.#config.verbose) {
-          this.#log("debug", `\u2190 ${response.response?.status} ${method} ${path}`, {
-            status: response.response?.status,
-            statusText: response.response?.statusText
-          });
-        }
-        if (response.error) {
-          this.#config.onRequestError(requestData, response.response, response.error);
-          await this.#handleOpenApiError(response.error, response.response, requestOrigin);
-        }
-        const result = response.data;
-        this.#config.onAfterRequest(requestData);
-        return result;
-      } catch (error) {
-        abortContext.clear();
-        if (error instanceof SyntaxError) {
-          throw new UnexpectedResponseError(
-            formatUnexpectedResponseMessage(error, method, requestUrl),
-            error,
-            requestOrigin
-          );
+          const requestOptions = {
+            signal: abortContext.signal,
+            headers: {
+              ...customHeaders,
+              ...this.#identityHeaders()
+            }
+          };
+          if (scopedParams) {
+            requestOptions.params = scopedParams;
+          }
+          if (body !== void 0) {
+            requestOptions.body = body;
+          }
+          let response;
+          switch (method) {
+            case "GET":
+              response = await this.#client.GET(path, requestOptions);
+              break;
+            case "POST":
+              response = await this.#client.POST(path, requestOptions);
+              break;
+            case "PUT":
+              response = await this.#client.PUT(path, requestOptions);
+              break;
+            case "DELETE":
+              response = await this.#client.DELETE(path, requestOptions);
+              break;
+            case "PATCH":
+              response = await this.#client.PATCH(path, requestOptions);
+              break;
+            default:
+              throw new ValidationError(`Unsupported HTTP method: ${method}`);
+          }
+          abortContext.clear();
+          if (this.#config.verbose) {
+            this.#log("debug", `\u2190 ${response.response?.status} ${method} ${path}`, {
+              status: response.response?.status,
+              statusText: response.response?.statusText
+            });
+          }
+          if (response.error) {
+            this.#config.onRequestError(requestData, response.response, response.error);
+            await this.#handleOpenApiError(response.error, response.response, requestOrigin);
+          }
+          const result = response.data;
+          this.#config.onAfterRequest(requestData);
+          return result;
+        } catch (error) {
+          abortContext.clear();
+          if (error instanceof SyntaxError) {
+            throw new UnexpectedResponseError(
+              formatUnexpectedResponseMessage(error, method, requestUrl),
+              error,
+              requestOrigin
+            );
+          }
+          throw this.#toTransportError(error, requestOrigin, abortContext);
         }
-        throw this.#toTransportError(error, requestOrigin, abortContext);
-      }
-    });
+      },
+      { retryServer429: this.#canRetryServer429(method) }
+    );
   };
   /**
    * Handle OpenAPI fetch errors. Always reads the real `response.status` so
@@ -10609,46 +10635,59 @@ var BugBugApiClient = class {
     };
     const requestOrigin = { method, url };
     this.#config.onBeforeRequest(requestData);
-    return this.#rateLimiter.execute(async () => {
-      const abortContext = this.#createAbortContext(signal, timeout);
-      try {
-        if (this.#config.verbose) {
-          this.#log("debug", `\u2192 ${method} ${path} (raw)`, { queryParams, pathParams });
-        }
-        const response = await fetch(url, {
-          method,
-          redirect,
-          headers: {
-            // Caller headers go first so the SDK's auth + identification
-            // headers always win — a stray `Authorization` in caller-supplied
-            // headers would otherwise silently replace the SDK token.
-            ...customHeaders,
-            ...authenticated ? this.#identityHeaders() : this.#requestHeaders(),
-            ...contentType ? { "Content-Type": contentType } : {}
-          },
-          ...body !== void 0 ? { body } : {},
-          signal: abortContext.signal
-        });
-        abortContext.clear();
-        if (this.#config.verbose) {
-          this.#log("debug", `\u2190 ${response.status} ${method} ${path}`, {
-            status: response.status,
-            statusText: response.statusText
+    return this.#rateLimiter.execute(
+      async () => {
+        const abortContext = this.#createAbortContext(signal, timeout);
+        try {
+          this.#throwIfAlreadyAborted(abortContext, requestOrigin);
+          if (this.#config.verbose) {
+            this.#log("debug", `\u2192 ${method} ${path} (raw)`, { queryParams, pathParams });
+          }
+          const response = await fetch(url, {
+            method,
+            redirect,
+            headers: {
+              // Caller headers go first so the SDK's auth + identification
+              // headers always win — a stray `Authorization` in caller-supplied
+              // headers would otherwise silently replace the SDK token.
+              ...customHeaders,
+              ...authenticated ? this.#identityHeaders() : this.#requestHeaders(),
+              ...contentType ? { "Content-Type": contentType } : {}
+            },
+            ...body !== void 0 ? { body } : {},
+            signal: abortContext.signal
           });
+          abortContext.clear();
+          if (this.#config.verbose) {
+            this.#log("debug", `\u2190 ${response.status} ${method} ${path}`, {
+              status: response.status,
+              statusText: response.statusText
+            });
+          }
+          if (!response.ok && !(acceptRedirect && response.status >= 300 && response.status < 400)) {
+            const errorText = await response.text();
+            this.#config.onRequestError(requestData, response, new Error(errorText));
+            await this.#handleOpenApiError(errorText, response, requestOrigin);
+          }
+          const result = await readBody(response);
+          this.#config.onAfterRequest(requestData);
+          return result;
+        } catch (error) {
+          abortContext.clear();
+          throw this.#toTransportError(error, requestOrigin, abortContext);
         }
-        if (!response.ok && !(acceptRedirect && response.status >= 300 && response.status < 400)) {
-          const errorText = await response.text();
-          this.#config.onRequestError(requestData, response, new Error(errorText));
-          await this.#handleOpenApiError(errorText, response, requestOrigin);
-        }
-        const result = await readBody(response);
-        this.#config.onAfterRequest(requestData);
-        return result;
-      } catch (error) {
-        abortContext.clear();
-        throw this.#toTransportError(error, requestOrigin, abortContext);
-      }
-    });
+      },
+      { retryServer429: this.#canRetryServer429(method) }
+    );
+  };
+  #canRetryServer429 = (method) => method === "GET" && this.#config.rateLimit.retryServer429 !== false;
+  #throwIfAlreadyAborted = (abortContext, requestOrigin) => {
+    if (!abortContext.signal.aborted) return;
+    throw this.#toTransportError(
+      new DOMException("The operation was aborted.", "AbortError"),
+      requestOrigin,
+      abortContext
+    );
   };
   #createAbortContext = (signal, timeout) => {
     const controller = new AbortController();
@@ -10713,9 +10752,12 @@ var BugBugApiClient = class {
     if (updates.apiToken || updates.apiUrl) {
       this.#client = this.#createApiClient();
     }
-    if (updates.rateLimit) {
+    if (updates.rateLimiter) {
+      this.#rateLimiter = updates.rateLimiter;
+    } else if (updates.rateLimit) {
       this.#rateLimiter = new RateLimiter(this.#config.rateLimit);
     }
+    this.#config.rateLimiter = this.#rateLimiter;
   };
   /**
    * Snapshot of the in-process rate-limiter state.
@@ -15606,6 +15648,7 @@ export {
   ProjectsModule,
   RUN_MODES,
   RateLimitError,
+  RateLimiter,
   RunModeSchema,
   SDK_ERROR_CODES,
   STEP_ERROR_CODES,