@mx-space/byline-api-client 0.3.0 → 0.3.2

package/README.md

@@ -34,7 +34,9 @@ resolves to `{ data, meta? }`, mirroring the server envelope. Responses are conv
 from the snake_case wire format to camelCase, except free-form subtrees (post `meta`,
 dynamic component `propsSchema`). Pass `camelCase: false` to keep the wire keys.
 Failures throw `BylineApiError` with the server's `status`, `code`, `message` and
-`details`; use `isBylineApiError(error)` to narrow.
+`details`; use `isBylineApiError(error)` to narrow. A successful response labelled JSON
+whose body is empty or not JSON throws code `INVALID_RESPONSE`; an error while
+reading the body (for example a connection cut off mid-stream) is rethrown as is.
 
 | Option      | Purpose                                                         |
 | ----------- | --------------------------------------------------------------- |

package/dist/index.cjs

@@ -105,7 +105,7 @@ var HttpCore = class {
 			signal: options.signal
 		});
 		if (response.status === 204) return { data: void 0 };
-		const payload = (response.headers.get("content-type") ?? "").includes("json") ? await response.json().catch(() => null) : await response.text();
+		const payload = (response.headers.get("content-type") ?? "").includes("json") ? await this.readJson(response, path) : await response.text();
 		if (!response.ok) throw this.toError(response.status, path, payload);
 		if (!isEnvelope(payload)) return { data: this.transform(payload, options.preserve) };
 		return {
@@ -113,6 +113,15 @@ var HttpCore = class {
 			...payload.meta === void 0 ? {} : { meta: this.transform(payload.meta) }
 		};
 	}
+	async readJson(response, path) {
+		try {
+			return await response.json();
+		} catch (error) {
+			if (!response.ok) return null;
+			if (!(error instanceof SyntaxError)) throw error;
+			throw new BylineApiError(response.status, "INVALID_RESPONSE", `Response body is not valid JSON: ${error.message}`, path);
+		}
+	}
 	transform(value, preserve) {
 		if (this.options.camelCase === false) return value;
 		return camelcaseKeys(value, preserve);

package/dist/index.d.cts

@@ -20,6 +20,7 @@ interface ArticleTranslationMeta {
   translatedAt?: string;
   model?: string;
   availableTranslations?: string[];
+  localizedTags?: string[];
 }
 interface EntryTranslationMeta {
   article?: ArticleTranslationMeta;
@@ -461,6 +462,7 @@ export declare class HttpCore {
   get lang(): string | undefined;
   buildUrl(path: string, query?: Record<string, QueryValue>): string;
   request<T, M = Record<string, unknown>>(method: HttpMethod, path: string, options?: RequestOptions): Promise<ApiResponse<T, M>>;
+  private readJson;
   private transform;
   private toError;
 }

package/dist/index.d.ts

@@ -20,6 +20,7 @@ interface ArticleTranslationMeta {
   translatedAt?: string;
   model?: string;
   availableTranslations?: string[];
+  localizedTags?: string[];
 }
 interface EntryTranslationMeta {
   article?: ArticleTranslationMeta;
@@ -461,6 +462,7 @@ export declare class HttpCore {
   get lang(): string | undefined;
   buildUrl(path: string, query?: Record<string, QueryValue>): string;
   request<T, M = Record<string, unknown>>(method: HttpMethod, path: string, options?: RequestOptions): Promise<ApiResponse<T, M>>;
+  private readJson;
   private transform;
   private toError;
 }

package/dist/index.js

@@ -104,7 +104,7 @@ var HttpCore = class {
 			signal: options.signal
 		});
 		if (response.status === 204) return { data: void 0 };
-		const payload = (response.headers.get("content-type") ?? "").includes("json") ? await response.json().catch(() => null) : await response.text();
+		const payload = (response.headers.get("content-type") ?? "").includes("json") ? await this.readJson(response, path) : await response.text();
 		if (!response.ok) throw this.toError(response.status, path, payload);
 		if (!isEnvelope(payload)) return { data: this.transform(payload, options.preserve) };
 		return {
@@ -112,6 +112,15 @@ var HttpCore = class {
 			...payload.meta === void 0 ? {} : { meta: this.transform(payload.meta) }
 		};
 	}
+	async readJson(response, path) {
+		try {
+			return await response.json();
+		} catch (error) {
+			if (!response.ok) return null;
+			if (!(error instanceof SyntaxError)) throw error;
+			throw new BylineApiError(response.status, "INVALID_RESPONSE", `Response body is not valid JSON: ${error.message}`, path);
+		}
+	}
 	transform(value, preserve) {
 		if (this.options.camelCase === false) return value;
 		return camelcaseKeys(value, preserve);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mx-space/byline-api-client",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Typed fetch client for the Byline headless CMS API",
   "keywords": [
     "byline",