@nekutima/biome-sdk 0.19.2 → 0.29.0

package/dist/core/api-diagnostics.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * Structured API failure diagnostics for BiomeSDK HTTP calls.
+ * Used by BiomeHttpClient to classify failures and surface them to consumers
+ * (e.g. Angular FE) via a CustomEvent + console logging.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BIOME_API_ERROR_EVENT = void 0;
+exports.extractRateLimitInfo = extractRateLimitInfo;
+exports.classifyApiFailure = classifyApiFailure;
+exports.buildApiFailureDiagnostic = buildApiFailureDiagnostic;
+exports.reportApiFailure = reportApiFailure;
+exports.failureKindToErrorCode = failureKindToErrorCode;
+exports.userMessageForTransportFailure = userMessageForTransportFailure;
+exports.BIOME_API_ERROR_EVENT = "biome:api-error";
+function headerValue(headers, name) {
+    if (!headers)
+        return undefined;
+    const lower = name.toLowerCase();
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() === lower) {
+            if (Array.isArray(value))
+                return value[0] != null ? String(value[0]) : undefined;
+            if (value == null)
+                return undefined;
+            return String(value);
+        }
+    }
+    return undefined;
+}
+function parsePositiveInt(value) {
+    if (value == null || value === "")
+        return undefined;
+    const n = parseInt(value, 10);
+    return Number.isFinite(n) && n >= 0 ? n : undefined;
+}
+/**
+ * Extract rate-limit metadata from standard RateLimit-* / Retry-After headers
+ * and optional JSON body fields.
+ */
+function extractRateLimitInfo(error) {
+    const headers = error.response?.headers;
+    const body = error.response?.data;
+    const limit = parsePositiveInt(headerValue(headers, "ratelimit-limit")) ??
+        parsePositiveInt(headerValue(headers, "x-ratelimit-limit"));
+    const remaining = parsePositiveInt(headerValue(headers, "ratelimit-remaining")) ??
+        parsePositiveInt(headerValue(headers, "x-ratelimit-remaining"));
+    const resetRaw = headerValue(headers, "ratelimit-reset") ??
+        headerValue(headers, "x-ratelimit-reset");
+    const retryAfterHeader = parsePositiveInt(headerValue(headers, "retry-after"));
+    const bodyRetryAfter = body?.payload?.retryAfter ??
+        body?.payload?.data?.retryAfter ??
+        body?.data?.retryAfter;
+    const retryAfterSeconds = retryAfterHeader ??
+        (typeof bodyRetryAfter === "number" && bodyRetryAfter >= 0
+            ? bodyRetryAfter
+            : undefined);
+    let reset;
+    if (resetRaw) {
+        // IETF draft RateLimit-Reset can be unix seconds or seconds-until-reset depending on server
+        const asNum = parsePositiveInt(resetRaw);
+        if (asNum != null) {
+            // Prefer absolute epoch if it looks like one (> year 2001 in seconds)
+            reset =
+                asNum > 1000000000
+                    ? new Date(asNum * 1000).toISOString()
+                    : new Date(Date.now() + asNum * 1000).toISOString();
+        }
+        else {
+            reset = resetRaw;
+        }
+    }
+    if (limit == null &&
+        remaining == null &&
+        reset == null &&
+        retryAfterSeconds == null) {
+        return undefined;
+    }
+    return { limit, remaining, reset, retryAfterSeconds };
+}
+/**
+ * Classify an HTTP client failure for diagnostics and UX.
+ */
+function classifyApiFailure(error) {
+    const status = error.response?.status;
+    const code = (error.code || "").toUpperCase();
+    const message = (error.message || "").toLowerCase();
+    if (status === 429) {
+        return "rate_limited";
+    }
+    // Client-side RequestScheduler wait exceeded — request never left the browser.
+    // Distinct from transport timeout (axios timeout after the socket was opened).
+    if (error.isQueueTimeout === true ||
+        code === "ERR_QUEUE_TIMEOUT" ||
+        message.includes("request queue wait timed out")) {
+        return "queue_timeout";
+    }
+    if (!error.response) {
+        if (code === "ECONNABORTED" ||
+            code === "ETIMEDOUT" ||
+            message.includes("timeout")) {
+            return "timeout";
+        }
+        if (code === "ERR_NETWORK" ||
+            code === "ECONNREFUSED" ||
+            code === "ENOTFOUND" ||
+            message.includes("network error")) {
+            return "network";
+        }
+        return "unknown";
+    }
+    if (status != null && status > 0) {
+        return "http_error";
+    }
+    return "unknown";
+}
+function truncateMessage(msg, max = 200) {
+    if (!msg)
+        return undefined;
+    const cleaned = msg.replace(/\s+/g, " ").trim();
+    if (cleaned.length <= max)
+        return cleaned;
+    return `${cleaned.slice(0, max)}…`;
+}
+/**
+ * Build a structured diagnostic payload from an axios-like error.
+ */
+function buildApiFailureDiagnostic(error, elapsedMs) {
+    const kind = classifyApiFailure(error);
+    const start = error.config?._startTime;
+    const computedElapsed = elapsedMs ?? (typeof start === "number" ? Date.now() - start : 0);
+    const data = error.response?.data;
+    const message = truncateMessage(data?.payload?.message || data?.message || error.message);
+    const rateLimit = extractRateLimitInfo(error);
+    return {
+        tag: "[BiomeSDK]",
+        kind,
+        method: error.config?.method?.toUpperCase(),
+        url: error.config?.url,
+        status: error.response?.status,
+        code: error.code,
+        elapsedMs: computedElapsed,
+        timeoutMs: error.config?.timeout ?? error.maxWaitMs,
+        message,
+        rateLimit,
+        scheduler: error.scheduler,
+        requestPriority: error.priority ?? error.config?.biomePriority,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Log a failure diagnostic and dispatch `biome:api-error` for FE consumers.
+ */
+function reportApiFailure(error, elapsedMs) {
+    const diagnostic = buildApiFailureDiagnostic(error, elapsedMs);
+    // Structured console log — easy to filter in browser DevTools
+    // eslint-disable-next-line no-console
+    console.error("[BiomeSDK] request failed", diagnostic);
+    if (typeof window !== "undefined" && typeof CustomEvent !== "undefined") {
+        try {
+            window.dispatchEvent(new CustomEvent(exports.BIOME_API_ERROR_EVENT, { detail: diagnostic }));
+        }
+        catch {
+            // Ignore environments where CustomEvent dispatch fails
+        }
+    }
+    return diagnostic;
+}
+/**
+ * Map failure kind to stable SDK error codes used in BiomeSdkError.code.
+ */
+function failureKindToErrorCode(kind) {
+    switch (kind) {
+        case "timeout":
+            return "TIMEOUT";
+        case "queue_timeout":
+            return "QUEUE_TIMEOUT";
+        case "network":
+            return "NETWORK_ERROR";
+        case "rate_limited":
+            return "RATE_LIMITED";
+        default:
+            return undefined;
+    }
+}
+/**
+ * User-facing message for timeout / network when the server did not respond.
+ */
+function userMessageForTransportFailure(kind, retryAfterSeconds) {
+    if (kind === "timeout") {
+        return "The request timed out before the server responded. Please try again.";
+    }
+    if (kind === "queue_timeout") {
+        return "Too many requests are in flight. Please wait a moment and try again.";
+    }
+    if (kind === "network") {
+        return "Network error. Check your connection and try again.";
+    }
+    if (kind === "rate_limited") {
+        if (retryAfterSeconds != null && retryAfterSeconds > 0) {
+            const minutes = Math.ceil(retryAfterSeconds / 60);
+            if (retryAfterSeconds >= 60) {
+                return `Too many requests. Please wait about ${minutes} minute${minutes === 1 ? "" : "s"} and try again.`;
+            }
+            return `Too many requests. Please wait ${retryAfterSeconds} second${retryAfterSeconds === 1 ? "" : "s"} and try again.`;
+        }
+        return "Too many requests. Please wait a moment and try again.";
+    }
+    return undefined;
+}
+//# sourceMappingURL=api-diagnostics.js.map

package/dist/core/api-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-diagnostics.js","sourceRoot":"","sources":["../../src/core/api-diagnostics.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AA4FH,oDAoDC;AAKD,gDA2CC;AAYD,8DA+BC;AAKD,4CAqBC;AAKD,wDAaC;AAKD,wEAwBC;AAhTY,QAAA,qBAAqB,GAAG,iBAAiB,CAAC;AA8DvD,SAAS,WAAW,CAClB,OAA4C,EAC5C,IAAY;IAEZ,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACjF,IAAI,KAAK,IAAI,IAAI;gBAAE,OAAO,SAAS,CAAC;YACpC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAyB;IACjD,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACpD,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAClC,KAA4B;IAE5B,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,OAA8C,CAAC;IAC/E,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC;IAElC,MAAM,KAAK,GACT,gBAAgB,CAAC,WAAW,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QACzD,gBAAgB,CAAC,WAAW,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC9D,MAAM,SAAS,GACb,gBAAgB,CAAC,WAAW,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;QAC7D,gBAAgB,CAAC,WAAW,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAClE,MAAM,QAAQ,GACZ,WAAW,CAAC,OAAO,EAAE,iBAAiB,CAAC;QACvC,WAAW,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IAC5C,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IAC/E,MAAM,cAAc,GAClB,IAAI,EAAE,OAAO,EAAE,UAAU;QACzB,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU;QAC/B,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC;IAEzB,MAAM,iBAAiB,GACrB,gBAAgB;QAChB,CAAC,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,IAAI,CAAC;YACxD,CAAC,CAAC,cAAc;YAChB,CAAC,CAAC,SAAS,CAAC,CAAC;IAEjB,IAAI,KAAyB,CAAC;IAC9B,IAAI,QAAQ,EAAE,CAAC;QACb,4FAA4F;QAC5F,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,sEAAsE;YACtE,KAAK;gBACH,KAAK,GAAG,UAAa;oBACnB,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;oBACtC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,QAAQ,CAAC;QACnB,CAAC;IACH,CAAC;IAED,IACE,KAAK,IAAI,IAAI;QACb,SAAS,IAAI,IAAI;QACjB,KAAK,IAAI,IAAI;QACb,iBAAiB,IAAI,IAAI,EACzB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,KAA4B;IAC7D,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC;IACtC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAEpD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,+EAA+E;IAC/E,+EAA+E;IAC/E,IACE,KAAK,CAAC,cAAc,KAAK,IAAI;QAC7B,IAAI,KAAK,mBAAmB;QAC5B,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAChD,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpB,IACE,IAAI,KAAK,cAAc;YACvB,IAAI,KAAK,WAAW;YACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAC3B,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IACE,IAAI,KAAK,aAAa;YACtB,IAAI,KAAK,cAAc;YACvB,IAAI,KAAK,WAAW;YACpB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,EACjC,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,eAAe,CAAC,GAAuB,EAAE,GAAG,GAAG,GAAG;IACzD,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,IAAI,OAAO,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,OAAO,CAAC;IAC1C,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CACvC,KAA4B,EAC5B,SAAkB;IAElB,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC;IACvC,MAAM,eAAe,GACnB,SAAS,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpE,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC;IAClC,MAAM,OAAO,GAAG,eAAe,CAC7B,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC,OAAO,CACzD,CAAC;IAEF,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAE9C,OAAO;QACL,GAAG,EAAE,YAAY;QACjB,IAAI;QACJ,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE;QAC3C,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG;QACtB,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,eAAe;QAC1B,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,IAAI,KAAK,CAAC,SAAS;QACnD,OAAO;QACP,SAAS;QACT,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,eAAe,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,EAAE,aAAa;QAC9D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAC9B,KAA4B,EAC5B,SAAkB;IAElB,MAAM,UAAU,GAAG,yBAAyB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAE/D,8DAA8D;IAC9D,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,UAAU,CAAC,CAAC;IAEvD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,WAAW,KAAK,WAAW,EAAE,CAAC;QACxE,IAAI,CAAC;YACH,MAAM,CAAC,aAAa,CAClB,IAAI,WAAW,CAAC,6BAAqB,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAC/D,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,IAAoB;IACzD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,eAAe;YAClB,OAAO,eAAe,CAAC;QACzB,KAAK,SAAS;YACZ,OAAO,eAAe,CAAC;QACzB,KAAK,cAAc;YACjB,OAAO,cAAc,CAAC;QACxB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,8BAA8B,CAC5C,IAAoB,EACpB,iBAA0B;IAE1B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,sEAAsE,CAAC;IAChF,CAAC;IACD,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;QAC7B,OAAO,sEAAsE,CAAC;IAChF,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,qDAAqD,CAAC;IAC/D,CAAC;IACD,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;QAC5B,IAAI,iBAAiB,IAAI,IAAI,IAAI,iBAAiB,GAAG,CAAC,EAAE,CAAC;YACvD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAC;YAClD,IAAI,iBAAiB,IAAI,EAAE,EAAE,CAAC;gBAC5B,OAAO,wCAAwC,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC;YAC5G,CAAC;YACD,OAAO,kCAAkC,iBAAiB,UAAU,iBAAiB,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC;QAC1H,CAAC;QACD,OAAO,wDAAwD,CAAC;IAClE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/configuration.d.ts

@@ -6,6 +6,12 @@ export interface BiomeConfig {
     apiBaseUrl: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
+    /**
+     * Max concurrent in-flight XHRs via BiomeHttpClient (default: 4).
+     * Leave headroom under the browser's ~6 connections/origin for chat SSE
+     * and Angular HttpClient traffic that shares the same origin.
+     */
+    maxConcurrentRequests?: number;
     /** Authentication token for API requests */
     authToken?: string;
     /** Additional HTTP headers */
@@ -13,6 +19,12 @@ export interface BiomeConfig {
     /** HTTP configuration */
     http?: {
         withCredentials?: boolean;
+        /**
+         * Persist `Set-Cookie` on the axios instance (JWT + CSRF).
+         * Defaults to true when `document` is undefined (Node). Browsers keep
+         * using `document.cookie` / `withCredentials`.
+         */
+        useNodeCookieJar?: boolean;
         interceptors?: {
             credentials?: boolean;
             taskNotificationRefresh?: {

package/dist/core/configuration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/core/configuration.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,yBAAyB;IACzB,IAAI,CAAC,EAAE;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,YAAY,CAAC,EAAE;YACX,WAAW,CAAC,EAAE,OAAO,CAAC;YACtB,uBAAuB,CAAC,EAAE;gBACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;gBAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;aACzB,CAAC;SACL,CAAC;KACL,CAAC;IACF,oCAAoC;IACpC,IAAI,CAAC,EAAE;QACH,6CAA6C;QAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,+CAA+C;QAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,kEAAkE;QAClE,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,kEAAkE;QAClE,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACL"}
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/core/configuration.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,yBAAyB;IACzB,IAAI,CAAC,EAAE;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B;;;;WAIG;QACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,YAAY,CAAC,EAAE;YACX,WAAW,CAAC,EAAE,OAAO,CAAC;YACtB,uBAAuB,CAAC,EAAE;gBACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;gBAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;aACzB,CAAC;SACL,CAAC;KACL,CAAC;IACF,oCAAoC;IACpC,IAAI,CAAC,EAAE;QACH,6CAA6C;QAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,+CAA+C;QAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,kEAAkE;QAClE,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,kEAAkE;QAClE,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACL"}

package/dist/core/error-handler.d.ts

@@ -11,8 +11,12 @@ export interface BiomeSdkError extends Error {
     userMessage?: string;
     /** Technical error details */
     technicalDetails?: string;
-    /** Error code from API (e.g., 'EMAIL_NOT_CONFIRMED', 'ACCOUNT_LOCKED') */
+    /** Error code from API (e.g., 'EMAIL_NOT_CONFIRMED', 'ACCOUNT_LOCKED', 'TIMEOUT', 'RATE_LIMITED') */
     code?: string;
+    /** Seconds until retry is allowed (rate limits / circuit breakers) */
+    retryAfter?: number;
+    /** Failure kind when classifiable (timeout, rate_limited, network, http_error, unknown) */
+    kind?: string;
     /** Timestamp when error occurred */
     timestamp: string;
     /** Original error */

package/dist/core/error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/core/error-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAE9F;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,GAAG,2BAA2B,CA6E7C"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/core/error-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAQ9F;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qGAAqG;IACrG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2FAA2F;IAC3F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AAWD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,GAAG,2BAA2B,CAgG7C"}

package/dist/core/error-handler.js

@@ -3,6 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSdkError = createSdkError;
 const axios_1 = require("axios");
 const prerequisite_error_1 = require("../errors/prerequisite-error");
+const api_diagnostics_1 = require("./api-diagnostics");
+/**
+ * Builds a genuine `Error` instance carrying the `BiomeSdkError` fields, so
+ * `error instanceof Error` checks at call sites succeed instead of always
+ * falling through to a generic fallback message.
+ */
+function buildSdkError(message, fields) {
+    return Object.assign(new Error(message), { name: "BiomeSdkError", ...fields });
+}
 /**
  * Create standardized error object
  * May return BiomeSdkError or PrerequisiteValidationError for specific conflict cases
@@ -23,62 +32,75 @@ function createSdkError(error, context) {
             const message = payload.message || getUserFriendlyErrorMessage(status, errorData);
             return new prerequisite_error_1.PrerequisiteValidationError(message, payload.unmetPrerequisites);
         }
-        return {
-            name: "BiomeSdkError",
-            message: error.message,
+        const kind = (0, api_diagnostics_1.classifyApiFailure)(error);
+        const rateLimit = (0, api_diagnostics_1.extractRateLimitInfo)(error);
+        const retryAfter = rateLimit?.retryAfterSeconds ??
+            (typeof payload?.retryAfter === "number" ? payload.retryAfter : undefined) ??
+            (typeof errorData?.data?.retryAfter === "number"
+                ? errorData.data.retryAfter
+                : undefined);
+        const transportMessage = (0, api_diagnostics_1.userMessageForTransportFailure)(kind, retryAfter);
+        const statusMessage = getUserFriendlyErrorMessage(status, errorData, retryAfter);
+        const userMessage = kind === "timeout" || kind === "network"
+            ? transportMessage || statusMessage
+            : kind === "rate_limited"
+                ? transportMessage || statusMessage
+                : statusMessage;
+        const kindCode = (0, api_diagnostics_1.failureKindToErrorCode)(kind);
+        const code = kindCode ||
+            errorData?.code ||
+            payload?.type ||
+            error.code;
+        return buildSdkError(error.message, {
             status,
-            userMessage: getUserFriendlyErrorMessage(status, errorData),
+            userMessage,
             technicalDetails: errorData?.message || error.message,
-            code: errorData?.code || payload?.type || error.code,
+            code,
+            kind,
+            retryAfter,
             type: payload?.type || errorData?.type,
             timestamp,
             originalError: error,
             unmetPrerequisites: payload?.unmetPrerequisites,
-        };
+        });
     }
     // Pass through PrerequisiteValidationError if already created
     if (error instanceof prerequisite_error_1.PrerequisiteValidationError) {
         return error;
     }
     if (error instanceof Error) {
-        return {
-            name: "BiomeSdkError",
-            message: error.message,
+        return buildSdkError(error.message, {
             userMessage: context ? `${context}: ${error.message}` : error.message,
             technicalDetails: error.message,
             timestamp,
             originalError: error,
-        };
+        });
     }
     // Handle cases where error might be null, undefined, or not an object
     if (!error || typeof error !== "object") {
-        return {
-            name: "BiomeSdkError",
-            message: "Unknown error occurred",
+        return buildSdkError("Unknown error occurred", {
             userMessage: context
                 ? `${context}: An unexpected error occurred`
                 : "An unexpected error occurred",
             technicalDetails: "Invalid error object received",
             timestamp,
             originalError: error,
-        };
+        });
     }
-    return {
-        name: "BiomeSdkError",
-        message: "Unknown error occurred",
+    return buildSdkError("Unknown error occurred", {
         userMessage: context
             ? `${context}: An unexpected error occurred`
             : "An unexpected error occurred",
         technicalDetails: "Unknown error",
         timestamp,
         originalError: error,
-    };
+    });
 }
 /**
  * Get user-friendly error message based on HTTP status
  */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-function getUserFriendlyErrorMessage(status, errorData) {
+function getUserFriendlyErrorMessage(status, errorData, retryAfterSeconds) {
     // Handle nested error structure (common in some APIs)
     const nestedError = errorData?.error;
     const directMessage = errorData?.message;
@@ -144,8 +166,10 @@ function getUserFriendlyErrorMessage(status, errorData) {
                 directMessage ||
                 nestedMessage ||
                 "The submitted data is invalid. Please check your input.");
-        case 429:
-            return payloadMessage || "Too many requests. Please wait a moment and try again.";
+        case 429: {
+            const rateLimited = (0, api_diagnostics_1.userMessageForTransportFailure)("rate_limited", retryAfterSeconds);
+            return payloadMessage || rateLimited || "Too many requests. Please wait a moment and try again.";
+        }
         case 500:
         case 502:
         case 503:

package/dist/core/error-handler.js.map

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

package/dist/core/http-client.d.ts

@@ -1,13 +1,29 @@
 import { AxiosRequestConfig } from "axios";
 import { BiomeConfig } from "./configuration";
+import { RequestPriority } from "./request-scheduler";
+/** Extended axios config for Biome request scheduling. */
+export interface BiomeRequestConfig extends AxiosRequestConfig {
+    /** Scheduling priority (default normal). Mutations should use high; background polls low. */
+    biomePriority?: RequestPriority;
+    /** Max ms to wait in the client queue before failing (default 30s; low priority often shorter). */
+    biomeQueueWaitMs?: number;
+    /** Internal: slot was acquired from RequestScheduler */
+    _biomeSlotHeld?: boolean;
+}
 /**
  * Framework-agnostic HTTP client using Axios
  */
 export declare class BiomeHttpClient {
+    #private;
     private config;
     private readonly axiosInstance;
+    private readonly scheduler;
+    private readonly nodeCookieJar;
     private _csrfToken;
     private _csrfInitialized;
+    /** Debounce handle for task → notification badge refresh (mutations only). */
+    private _taskNotifRefreshTimer;
+    private _taskNotifBroadcast;
     /**
      * Get the base URL configured for this client
      */
@@ -22,7 +38,18 @@ export declare class BiomeHttpClient {
      */
     fetchCsrfToken(url: string): Promise<string>;
     /**
-     * Get CSRF token from stored value or cookie
+     * Get the current CSRF token.
+     *
+     * Browser context (no node cookie jar): always reads document.cookie live rather than
+     * serving a cached value. A cached value would go stale across a same-tab
+     * logout->login cycle, since the server rotates the CSRF cookie on login but nothing
+     * else would invalidate this client's in-memory copy - the first mutating request
+     * after re-login would then send a stale header, get a 403 CSRF_TOKEN_INVALID, and be
+     * misread as "session expired" even though the new session is perfectly valid.
+     *
+     * Node cookie jar context: no live document.cookie to read (or the caller explicitly
+     * opted into the node cookie jar via config), so the value ingested by
+     * #ingestCookies() from the most recent Set-Cookie response header is served instead.
      */
     getCsrfToken(): string | null;
     /**
@@ -40,23 +67,23 @@ export declare class BiomeHttpClient {
     /**
      * Perform GET request
      */
-    get<T>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    get<T>(url: string, config?: BiomeRequestConfig): Promise<T>;
     /**
      * Perform POST request
      */
-    post<T>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    post<T>(url: string, data?: unknown, config?: BiomeRequestConfig): Promise<T>;
     /**
      * Perform PUT request
      */
-    put<T>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    put<T>(url: string, data?: unknown, config?: BiomeRequestConfig): Promise<T>;
     /**
      * Perform PATCH request
      */
-    patch<T>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    patch<T>(url: string, data?: unknown, config?: BiomeRequestConfig): Promise<T>;
     /**
      * Perform DELETE request
      */
-    delete<T = void>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    delete<T = void>(url: string, config?: BiomeRequestConfig): Promise<T>;
     /**
      * Set authentication token for subsequent requests
      */

package/dist/core/http-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/core/http-client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAiB,kBAAkB,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAM9C;;GAEG;AACH,qBAAa,eAAe;IAYd,OAAO,CAAC,MAAM;IAX1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,gBAAgB,CAAS;IAEjC;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;gBAEmB,MAAM,EAAE,WAAW;IAcvC;;OAEG;YACW,QAAQ;IAYtB;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAalD;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IA0B7B;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,cAAc,IAAI,IAAI;IAItB;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKlE;;OAEG;IACG,IAAI,CAAC,CAAC,EACV,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACG,GAAG,CAAC,CAAC,EACT,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACG,KAAK,CAAC,CAAC,EACX,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAK5E;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMjC;;OAEG;IACH,cAAc,IAAI,IAAI;IAKtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA6D1B"}
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/core/http-client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAiB,kBAAkB,EAA6C,MAAM,OAAO,CAAC;AAC5G,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,OAAO,EAEL,eAAe,EAEhB,MAAM,qBAAqB,CAAC;AAW7B,0DAA0D;AAC1D,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,6FAA6F;IAC7F,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,eAAe;;IAiBd,OAAO,CAAC,MAAM;IAhB1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IACrD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,gBAAgB,CAAS;IACjC,8EAA8E;IAC9E,OAAO,CAAC,sBAAsB,CAA8C;IAC5E,OAAO,CAAC,mBAAmB,CAAiC;IAE5D;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;gBAEmB,MAAM,EAAE,WAAW;IAoFvC;;OAEG;YACW,QAAQ;IAYtB;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAelD;;;;;;;;;;;;;OAaG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAwB7B;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,cAAc,IAAI,IAAI;IAItB;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKlE;;OAEG;IACG,IAAI,CAAC,CAAC,EACV,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACG,GAAG,CAAC,CAAC,EACT,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACG,KAAK,CAAC,CAAC,EACX,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAyB5E;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMjC;;OAEG;IACH,cAAc,IAAI,IAAI;IAKtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA4I1B"}