@beacon-build/sdk 3.23.0 → 3.25.0

package/dist/transport/binary-client.js

@@ -1,4 +1,5 @@
 import { SdkError, statusToSdkCode } from './errors.js';
+import { describeHttpFailure } from './http-failure.js';
 /**
  * BinaryClient — Binary download transport for storage proxy endpoints.
  * Returns Blob + metadata (contentType, contentLength, filename from Content-Disposition).
@@ -33,8 +34,8 @@ export class BinaryClient {
             throw new SdkError('unauthorized', 'Unauthorized', 401);
         }
         if (!res.ok) {
-            const code = statusToSdkCode(res.status);
-            throw new SdkError(code, `HTTP ${res.status}`, res.status);
+            const failure = await describeHttpFailure(res, { url, method: 'GET', path });
+            throw new SdkError(statusToSdkCode(res.status), failure.message, res.status, failure.apiCode, failure.details);
         }
         const blob = await res.blob();
         const contentType = res.headers.get('content-type') ?? 'application/octet-stream';

package/dist/transport/binary-client.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/transport/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AASvD,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACxC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,CAAA;IAC3D,8FAA8F;IAC9F,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACvB;AAED,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,aAAa,CAAA;CACzB;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IACP,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,gBAAgB;YAE9B,OAAO;IASrB;;;;;;OAMG;YACW,WAAW;IAmHzB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/D;;;OAGG;IACH,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC;IAIvE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAOjD;;;;;OAKG;IACH,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAQzD;;;OAGG;IACH,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAOrF,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAOjD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAOhD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAGtC"}
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/transport/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAUvD,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACxC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,CAAA;IAC3D,8FAA8F;IAC9F,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACvB;AAED,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,aAAa,CAAA;CACzB;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IACP,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,gBAAgB;YAE9B,OAAO;IASrB;;;;;;OAMG;YACW,WAAW;IAsGzB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/D;;;OAGG;IACH,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC;IAIvE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAOjD;;;;;OAKG;IACH,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAQzD;;;OAGG;IACH,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAOrF,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAOjD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAOhD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAGtC"}

package/dist/transport/http-client.js

@@ -1,4 +1,5 @@
 import { ImplementationDoneGateRefusal, SdkError, apiCodeToSdkCode, statusToSdkCode, } from './errors.js';
+import { describeHttpFailure } from './http-failure.js';
 import { requestOriginHeaders } from './request-origin.js';
 /**
  * HttpClient — JSON HTTP wrapper for User-JWT and Agent-JWT authenticated requests.
@@ -80,41 +81,20 @@ export class HttpClient {
         // status mapping is unchanged: statusToSdkCode(401) keeps `code: 'unauthorized'` when
         // the body names no (or an unrecognised) code.
         if (!res.ok) {
-            let code = statusToSdkCode(res.status);
-            let message = `HTTP ${res.status}`;
+            // B1505/AC-3: `describeHttpFailure` reads the body once (JSON or plain text). The
+            // body's own message stays the message when it sent one (callers match on it); only
+            // the otherwise-bare "HTTP <status>" fallback is enriched with host/server/text.
+            const detail = await describeHttpFailure(res, { url, path });
             // F603/AC-5: the verbatim body `code`, symmetric with the Ops path
-            // (transport/ops-api-client.ts) — was computed via body.code above but never
-            // threaded into the SdkError itself, so JWT-path callers could not read it.
-            let apiCode;
-            let details;
-            try {
-                const body = await res.json();
-                // Prefer body.code for precise error classification (e.g. 422 VALIDATION vs INVALID_TRANSITION);
-                // the API's global error envelope nests it as body.error.code (F564: e.g. the
-                // contributor-gating 409s thrown from the org-member write path).
-                const bodyCode = typeof body?.code === 'string'
-                    ? body.code
-                    : typeof body?.error?.code === 'string'
-                        ? body.error.code
-                        : undefined;
-                if (bodyCode) {
-                    apiCode = bodyCode;
-                    code = apiCodeToSdkCode(bodyCode, res.status);
-                }
-                if (body?.error?.message)
-                    message = body.error.message;
-                else if (typeof body?.error === 'string')
-                    message = body.error;
-                details = body?.details ?? body?.error?.details;
-            }
-            catch (_err) {
-                // Deliberately swallowed: an unparsable error body (e.g. non-JSON) must not
-                // block throwing the SdkError below — it falls back to the status-derived
-                // `code`/`message` computed above the try block.
-            }
-            const failure = new SdkError(code, message, res.status, apiCode, details);
+            // (transport/ops-api-client.ts). Prefer it for precise error classification (e.g.
+            // 422 VALIDATION vs INVALID_TRANSITION); the API's global error envelope nests it as
+            // body.error.code (F564).
+            const code = detail.apiCode
+                ? apiCodeToSdkCode(detail.apiCode, res.status)
+                : statusToSdkCode(res.status);
+            const failure = new SdkError(code, detail.bodyMessage ?? detail.message, res.status, detail.apiCode, detail.details);
             // F805/AC-12: the typed refusal of the implementation_done gate keeps its uncovered list
-            throw apiCode === 'IMPLEMENTATION_DONE_GATE'
+            throw detail.apiCode === 'IMPLEMENTATION_DONE_GATE'
                 ? new ImplementationDoneGateRefusal(failure)
                 : failure;
         }

package/dist/transport/http-client.js.map

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

package/dist/transport/http-failure.d.ts

@@ -0,0 +1,31 @@
+/**
+ * B1505/AC-3: one place that turns a non-ok `Response` into the facts an operator needs.
+ *
+ * A bare `HTTP 503` hides WHICH hop answered (the API, a proxy/ingress restarting the container,
+ * a consumer's own gateway) and WHAT it said. Every SDK transport reads its failure through
+ * `describeHttpFailure` so the message always names the status, the host of the request, the
+ * answering `Server`/`Via` header when present, and the body's code/text (or says plainly that
+ * the body was empty — the signature of an ingress answer, not of the API).
+ */
+export interface HttpFailureContext {
+    /** The absolute request URL (its host is the hop the request was addressed to). */
+    url: string;
+    method?: string;
+    /** Request path, shown instead of the full URL (the host is named separately). */
+    path?: string;
+}
+export interface HttpFailureDetail {
+    /** `HTTP 503 POST /p from host (server: x) — <body message | body text | empty body note>`. */
+    message: string;
+    /** The body's own message (`error.message`, `error` string, `message`), if it sent one. */
+    bodyMessage?: string;
+    /** The body's verbatim `code` / `error.code`. */
+    apiCode?: string;
+    /** `apiCode` only when it sat at the top level (`{ code }`), not nested (`{ error: { code } }`). */
+    topLevelCode?: string;
+    details?: Record<string, unknown>;
+    /** Host the request was addressed to (empty when the URL is unparsable). */
+    host: string;
+}
+export declare function describeHttpFailure(res: Response, ctx: HttpFailureContext): Promise<HttpFailureDetail>;
+//# sourceMappingURL=http-failure.d.ts.map

package/dist/transport/http-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-failure.d.ts","sourceRoot":"","sources":["../../src/transport/http-failure.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,kBAAkB;IAC/B,mFAAmF;IACnF,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAC9B,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAA;IACf,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oGAAoG;IACpG,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAA;CACf;AAuBD,wBAAsB,mBAAmB,CACrC,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,kBAAkB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CA4D5B"}

package/dist/transport/http-failure.js

@@ -0,0 +1,88 @@
+/**
+ * B1505/AC-3: one place that turns a non-ok `Response` into the facts an operator needs.
+ *
+ * A bare `HTTP 503` hides WHICH hop answered (the API, a proxy/ingress restarting the container,
+ * a consumer's own gateway) and WHAT it said. Every SDK transport reads its failure through
+ * `describeHttpFailure` so the message always names the status, the host of the request, the
+ * answering `Server`/`Via` header when present, and the body's code/text (or says plainly that
+ * the body was empty — the signature of an ingress answer, not of the API).
+ */
+const MAX_BODY_TEXT = 300;
+function hostOf(url) {
+    try {
+        return new URL(url).host;
+    }
+    catch (_err) {
+        // Unparsable URL: the message falls back to the raw string below, never to nothing.
+        return url;
+    }
+}
+/** HTML/text error pages (ingress 503s): drop tags, collapse whitespace, cap the length. */
+function plainText(raw) {
+    return raw
+        .replace(/<(script|style)[\s\S]*?<\/\1>/gi, ' ')
+        .replace(/<[^>]*>/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, MAX_BODY_TEXT);
+}
+export async function describeHttpFailure(res, ctx) {
+    const host = hostOf(ctx.url);
+    let raw = '';
+    try {
+        raw = typeof res.text === 'function' ? await res.text() : '';
+    }
+    catch (_err) {
+        // Body unreadable (aborted/consumed): treated as empty, the status + host still go out.
+    }
+    let apiCode;
+    let topLevelCode;
+    let details;
+    let bodyMessage;
+    let text = '';
+    if (raw.trim()) {
+        try {
+            const b = JSON.parse(raw);
+            const err = b?.error;
+            const errObj = err && typeof err === 'object' ? err : undefined;
+            if (typeof b?.code === 'string') {
+                apiCode = b.code;
+                topLevelCode = b.code;
+            }
+            else if (typeof errObj?.code === 'string')
+                apiCode = errObj.code;
+            if (typeof errObj?.message === 'string')
+                bodyMessage = errObj.message;
+            else if (typeof err === 'string')
+                bodyMessage = err;
+            else if (typeof b?.message === 'string')
+                bodyMessage = b.message;
+            details = b?.details ?? errObj?.details;
+            text = bodyMessage ?? (apiCode ? '' : plainText(raw));
+        }
+        catch (_err) {
+            // Not JSON (HTML error page, plain text): the text itself is the diagnosis.
+            text = plainText(raw);
+        }
+    }
+    // Optional chaining: transports are tested with minimal Response doubles (no headers).
+    const server = res.headers?.get?.('server') ?? res.headers?.get?.('via');
+    const where = `${ctx.method ? ` ${ctx.method}` : ''}${ctx.path ? ` ${ctx.path}` : ''}`;
+    const parts = [`HTTP ${res.status}${where} from ${host}${server ? ` (server: ${server})` : ''}`];
+    if (apiCode)
+        parts.push(`[${apiCode}]`);
+    parts.push(text
+        ? `— ${text}`
+        : raw.trim()
+            ? ''
+            : '— empty response body (no API error code; a proxy/ingress or restarting upstream answered)');
+    return {
+        message: parts.filter(Boolean).join(' '),
+        bodyMessage,
+        apiCode,
+        topLevelCode,
+        details,
+        host,
+    };
+}
+//# sourceMappingURL=http-failure.js.map

package/dist/transport/http-failure.js.map

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

package/dist/transport/multipart-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multipart-client.d.ts","sourceRoot":"","sources":["../../src/transport/multipart-client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG;QAAE,MAAM,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC5C;AAED,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IACpC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;CAC9B;AAED;;;;GAIG;AACH,qBAAa,eAAe;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,qBAAqB;IAE3C,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC;CAgF7E"}
+{"version":3,"file":"multipart-client.d.ts","sourceRoot":"","sources":["../../src/transport/multipart-client.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG;QAAE,MAAM,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC5C;AAED,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IACpC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;CAC9B;AAED;;;;GAIG;AACH,qBAAa,eAAe;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,qBAAqB;IAE3C,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC;CA6E7E"}

package/dist/transport/multipart-client.js

@@ -1,4 +1,5 @@
 import { SdkError, statusToSdkCode } from './errors.js';
+import { describeHttpFailure } from './http-failure.js';
 /**
  * MultipartClient — Multipart/form-data upload transport.
  * Used for asset uploads, avatar uploads, and storage uploads.
@@ -64,20 +65,8 @@ export class MultipartClient {
             throw new SdkError('unauthorized', 'Unauthorized', 401);
         }
         if (!res.ok) {
-            const code = statusToSdkCode(res.status);
-            let message = `HTTP ${res.status}`;
-            try {
-                const body = await res.json();
-                if (body?.error?.message)
-                    message = body.error.message;
-                else if (typeof body?.error === 'string')
-                    message = body.error;
-            }
-            catch (_err) {
-                // Deliberately swallowed: an unparsable error body must not block throwing
-                // the SdkError below — it falls back to the status-derived message above.
-            }
-            throw new SdkError(code, message, res.status);
+            const failure = await describeHttpFailure(res, { url, method: 'POST', path });
+            throw new SdkError(statusToSdkCode(res.status), failure.message, res.status, failure.apiCode, failure.details);
         }
         if (res.status === 204)
             return undefined;

package/dist/transport/multipart-client.js.map

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

package/dist/transport/sse-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse-client.d.ts","sourceRoot":"","sources":["../../src/transport/sse-client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;IACzC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,cAAc,KAAK,IAAI,CAAA;CAC5C;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,KAAK,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CACvC;AAED;;;;;;;GAOG;AACH,qBAAa,SAAS;IACN,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE3C,MAAM,CACF,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,EACzB,IAAI,CAAC,EAAE,OAAO,GACf,eAAe;CAyHrB"}
+{"version":3,"file":"sse-client.d.ts","sourceRoot":"","sources":["../../src/transport/sse-client.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;IACzC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,cAAc,KAAK,IAAI,CAAA;CAC5C;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,KAAK,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CACvC;AAED;;;;;;;GAOG;AACH,qBAAa,SAAS;IACN,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE3C,MAAM,CACF,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,EACzB,IAAI,CAAC,EAAE,OAAO,GACf,eAAe;CA+HrB"}

package/dist/transport/sse-client.js

@@ -1,4 +1,5 @@
 import { SdkError, statusToSdkCode } from './errors.js';
+import { describeHttpFailure } from './http-failure.js';
 /**
  * SseClient — Generic SSE stream reader for Ops SSE endpoints.
  * Handles: POST /api/v1/ops/db/migrate|seed|reset, GET /api/v1/ops/services/:id/logs,
@@ -47,7 +48,11 @@ export class SseClient {
                 throw error;
             }
             if (!res.ok || !res.body) {
-                const error = new SdkError(statusToSdkCode(res.status), `HTTP ${res.status}`, res.status);
+                // B1505/AC-3: never a bare "HTTP 503" — name the host/hop and the body's code/text.
+                const failure = await describeHttpFailure(res, { url, method, path });
+                const error = new SdkError(statusToSdkCode(res.status), res.ok
+                    ? `${failure.message} (stream response carried no body)`
+                    : failure.message, res.status, failure.apiCode, failure.details);
                 handler.onError?.(error);
                 throw error;
             }

package/dist/transport/sse-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"sse-client.js","sourceRoot":"","sources":["../../src/transport/sse-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AA+BvD;;;;;;;GAOG;AACH,MAAM,OAAO,SAAS;IACE;IAApB,YAAoB,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAE/C,MAAM,CACF,MAAsB,EACtB,IAAY,EACZ,OAAyB,EACzB,IAAc;QAEd,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,IAAI,OAAO,GAAG,KAAK,CAAA;QAEnB,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;YACxB,IAAI,UAAkB,CAAA;YACtB,IAAI,CAAC;gBACD,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAA;YAClD,CAAC;YAAC,MAAM,CAAC;gBACL,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,iCAAiC,CAAC,CAAA;YACzE,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAA;YAClD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,QAAQ,GAAG,IAAI,EAAE,CAAA;YAEtD,IAAI,GAAa,CAAA;YACjB,IAAI,CAAC;gBACD,MAAM,IAAI,GAAgB;oBACtB,MAAM;oBACN,OAAO,EAAE;wBACL,aAAa,EAAE,UAAU;wBACzB,MAAM,EAAE,mBAAmB;wBAC3B,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBACxE;oBACD,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;oBAC3D,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC5B,CAAA;gBACD,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YAChC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,IAAI,OAAO;oBAAE,OAAM;gBACnB,MAAM,KAAK,GAAG,IAAI,QAAQ,CACtB,eAAe,EACf,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAChE,CAAA;gBACD,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;gBACxB,MAAM,KAAK,CAAA;YACf,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,IAAI,QAAQ,CACtB,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAC3B,QAAQ,GAAG,CAAC,MAAM,EAAE,EACpB,GAAG,CAAC,MAAM,CACb,CAAA;gBACD,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;gBACxB,MAAM,KAAK,CAAA;YACf,CAAC;YAED,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;YACnC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;YACjC,IAAI,MAAM,GAAG,EAAE,CAAA;YAEf,wEAAwE;YACxE,2EAA2E;YAC3E,IAAI,SAAS,GAAkB,IAAI,CAAA;YACnC,IAAI,SAAS,GAAG,EAAE,CAAA;YAClB,IAAI,OAA2B,CAAA;YAE/B,OAAO,IAAI,EAAE,CAAC;gBACV,IAAI,KAA2C,CAAA;gBAC/C,IAAI,CAAC;oBACD,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;gBAC/B,CAAC;gBAAC,OAAO,IAAI,EAAE,CAAC;oBACZ,IAAI,OAAO;wBAAE,OAAM;oBACnB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;oBAChD,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;oBACxB,OAAM;gBACV,CAAC;gBAED,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBACb,OAAO,CAAC,MAAM,EAAE,EAAE,CAAA;oBAClB,OAAM;gBACV,CAAC;gBAED,sEAAsE;gBACtE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;gBACvD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;gBAChC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAA;gBAE1B,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;oBAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;oBACpE,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC5B,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;oBACpC,CAAC;yBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;wBAClC,0DAA0D;wBAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;wBAClC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;oBAC5D,CAAC;yBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;wBAChC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;oBAClC,CAAC;yBAAM,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;wBACrB,iBAAiB;wBACjB,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;4BACzB,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;gCACvB,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;gCACnE,MAAM,CAAC,MAAM,EAAE,CAAA;gCACf,OAAM;4BACV,CAAC;4BACD,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;gCACxB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,SAAS,IAAI,iBAAiB,CAAC,CAAA;gCACvD,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;gCACxB,MAAM,CAAC,MAAM,EAAE,CAAA;gCACf,OAAM;4BACV,CAAC;4BACD,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;wBACxE,CAAC;wBACD,SAAS,GAAG,IAAI,CAAA;wBAChB,SAAS,GAAG,EAAE,CAAA;wBACd,OAAO,GAAG,SAAS,CAAA;oBACvB,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC,CAAC,EAAE,CAAA;QAEJ,OAAO;YACH,OAAO;YACP,KAAK,EAAE,GAAG,EAAE;gBACR,OAAO,GAAG,IAAI,CAAA;gBACd,UAAU,CAAC,KAAK,EAAE,CAAA;YACtB,CAAC;SACJ,CAAA;IACL,CAAC;CACJ"}
+{"version":3,"file":"sse-client.js","sourceRoot":"","sources":["../../src/transport/sse-client.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beacon-build/sdk",
-  "version": "3.23.0",
+  "version": "3.25.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -28,7 +28,7 @@
     "@types/react": "^19.2.0",
     "@types/react-dom": "^19.2.0",
     "event-source-polyfill": "^1.0.31",
-    "@beacon-build/core": "3.23.0"
+    "@beacon-build/core": "3.25.0"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.2",
@@ -42,6 +42,14 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public"