@atscript/db-client 0.1.128 → 0.1.129

package/dist/index.cjs

@@ -56,6 +56,24 @@ var VersionMismatchError = class extends ClientError {
 		return this.body.currentVersion;
 	}
 };
+/**
+* Thrown by `Client` when NO server verdict was obtained: `fetch` itself
+* rejected (network down, DNS, CORS, `AbortError`, …) or a 2xx response
+* carried a body that is not JSON. Unlike {@link ClientError} — where the
+* server answered and rejected — the request's outcome is unknown: a write
+* may have committed. Reload before retrying a non-idempotent write.
+* The underlying error is the standard `cause`.
+*/
+var TransportError = class extends Error {
+	method;
+	url;
+	name = "TransportError";
+	constructor(method, url, detail, cause) {
+		super(`${method} ${url}: ${detail}`, { cause });
+		this.method = method;
+		this.url = url;
+	}
+};
 /** Thrown by `Client.action()` when the action name is not present in `/meta`. */
 var ActionNotFoundError = class extends Error {
 	action;
@@ -430,14 +448,20 @@ var Client = class {
 		return init;
 	}
 	async _send(url, init, allowEmpty) {
-		const res = await this._fetch(url, init);
+		const method = init.method ?? "GET";
+		let res;
+		try {
+			res = await this._fetch(url, init);
+		} catch (cause) {
+			throw new TransportError(method, url, describeCause(cause), cause);
+		}
 		if (!res.ok) {
 			let errorBody;
 			try {
 				errorBody = await res.json();
 			} catch {
 				errorBody = {
-					message: res.statusText,
+					message: res.statusText || `HTTP ${res.status}`,
 					statusCode: res.status
 				};
 			}
@@ -445,7 +469,11 @@ var Client = class {
 			if (errorBody.kind === "version_mismatch") throw new VersionMismatchError(res.status, errorBody);
 			throw new ClientError(res.status, errorBody);
 		}
-		if (!allowEmpty) return res.json();
+		if (!allowEmpty) try {
+			return await res.json();
+		} catch (cause) {
+			throw new TransportError(method, url, `HTTP ${res.status} body is not JSON (${describeCause(cause)})`, cause);
+		}
 		if (res.status === 204 || res.headers.get("content-length") === "0") return void 0;
 		try {
 			return await res.json();
@@ -454,6 +482,11 @@ var Client = class {
 		}
 	}
 };
+/** One-line rendering of a thrown value for a `TransportError` message. */
+function describeCause(cause) {
+	if (cause instanceof Error) return cause.message || cause.name;
+	return String(cause);
+}
 /**
 * Render a single identifier field for substitution into a navigate-URL
 * template or human-readable string. `null` / `undefined` collapse to `""`
@@ -495,6 +528,7 @@ exports.ActionNotFoundError = ActionNotFoundError;
 exports.ActionUnsupportedError = ActionUnsupportedError;
 exports.Client = Client;
 exports.ClientError = ClientError;
+exports.TransportError = TransportError;
 exports.VersionMismatchError = VersionMismatchError;
 exports.encodeNavigateId = encodeNavigateId;
 exports.formatIdentifier = formatIdentifier;

package/dist/index.d.cts

@@ -295,6 +295,28 @@ declare class VersionMismatchError extends ClientError {
   /** Row's current server-side version — clients refresh + retry against it. */
   get currentVersion(): number;
 }
+/**
+ * Thrown by `Client` when NO server verdict was obtained: `fetch` itself
+ * rejected (network down, DNS, CORS, `AbortError`, …) or a 2xx response
+ * carried a body that is not JSON. Unlike {@link ClientError} — where the
+ * server answered and rejected — the request's outcome is unknown: a write
+ * may have committed. Reload before retrying a non-idempotent write.
+ * The underlying error is the standard `cause`.
+ */
+declare class TransportError extends Error {
+  /** HTTP method of the failed request. */
+  readonly method: string;
+  /** Full request URL. */
+  readonly url: string;
+  name: string;
+  constructor(/** HTTP method of the failed request. */
+
+  method: string, /** Full request URL. */
+
+  url: string, /** What went wrong; the message is `<method> <url>: <detail>`. */
+
+  detail: string, cause?: unknown);
+}
 /** Thrown by `Client.action()` when the action name is not present in `/meta`. */
 declare class ActionNotFoundError extends Error {
   readonly action: string;
@@ -314,4 +336,4 @@ declare class ActionUnsupportedError extends Error {
   constructor(action: string, processor: string, message: string);
 }
 //#endregion
-export { ActionDisabledError, type ActionDisabledErrorBody, ActionNotFoundError, ActionUnsupportedError, type AggregateQuery, type AggregateResult, type AtscriptClientShape, Client, ClientError, type ClientOptions, type ClientResponse, type ClientValidationError, type ClientValidator, type ClientValidatorOptions, type DataOf, type DbPatch, type DbRow, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type OwnOf, type PageResult, type PatchOf, type RelationInfo, type RowOf, type SearchIndexInfo, type ServerError, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbDeleteResult, type TDbInsertManyResult, type TDbInsertResult, type TDbUpdateResult, type TSerializedAnnotatedType, type TypedWithRelation, type Uniquery, type UniqueryControls, type ValidatorMode, VersionMismatchError, type VersionMismatchErrorBody, encodeNavigateId, formatIdentifier, formatIdentifierField };
+export { ActionDisabledError, type ActionDisabledErrorBody, ActionNotFoundError, ActionUnsupportedError, type AggregateQuery, type AggregateResult, type AtscriptClientShape, Client, ClientError, type ClientOptions, type ClientResponse, type ClientValidationError, type ClientValidator, type ClientValidatorOptions, type DataOf, type DbPatch, type DbRow, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type OwnOf, type PageResult, type PatchOf, type RelationInfo, type RowOf, type SearchIndexInfo, type ServerError, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbDeleteResult, type TDbInsertManyResult, type TDbInsertResult, type TDbUpdateResult, type TSerializedAnnotatedType, TransportError, type TypedWithRelation, type Uniquery, type UniqueryControls, type ValidatorMode, VersionMismatchError, type VersionMismatchErrorBody, encodeNavigateId, formatIdentifier, formatIdentifierField };

package/dist/index.d.mts

@@ -295,6 +295,28 @@ declare class VersionMismatchError extends ClientError {
   /** Row's current server-side version — clients refresh + retry against it. */
   get currentVersion(): number;
 }
+/**
+ * Thrown by `Client` when NO server verdict was obtained: `fetch` itself
+ * rejected (network down, DNS, CORS, `AbortError`, …) or a 2xx response
+ * carried a body that is not JSON. Unlike {@link ClientError} — where the
+ * server answered and rejected — the request's outcome is unknown: a write
+ * may have committed. Reload before retrying a non-idempotent write.
+ * The underlying error is the standard `cause`.
+ */
+declare class TransportError extends Error {
+  /** HTTP method of the failed request. */
+  readonly method: string;
+  /** Full request URL. */
+  readonly url: string;
+  name: string;
+  constructor(/** HTTP method of the failed request. */
+
+  method: string, /** Full request URL. */
+
+  url: string, /** What went wrong; the message is `<method> <url>: <detail>`. */
+
+  detail: string, cause?: unknown);
+}
 /** Thrown by `Client.action()` when the action name is not present in `/meta`. */
 declare class ActionNotFoundError extends Error {
   readonly action: string;
@@ -314,4 +336,4 @@ declare class ActionUnsupportedError extends Error {
   constructor(action: string, processor: string, message: string);
 }
 //#endregion
-export { ActionDisabledError, type ActionDisabledErrorBody, ActionNotFoundError, ActionUnsupportedError, type AggregateQuery, type AggregateResult, type AtscriptClientShape, Client, ClientError, type ClientOptions, type ClientResponse, type ClientValidationError, type ClientValidator, type ClientValidatorOptions, type DataOf, type DbPatch, type DbRow, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type OwnOf, type PageResult, type PatchOf, type RelationInfo, type RowOf, type SearchIndexInfo, type ServerError, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbDeleteResult, type TDbInsertManyResult, type TDbInsertResult, type TDbUpdateResult, type TSerializedAnnotatedType, type TypedWithRelation, type Uniquery, type UniqueryControls, type ValidatorMode, VersionMismatchError, type VersionMismatchErrorBody, encodeNavigateId, formatIdentifier, formatIdentifierField };
+export { ActionDisabledError, type ActionDisabledErrorBody, ActionNotFoundError, ActionUnsupportedError, type AggregateQuery, type AggregateResult, type AtscriptClientShape, Client, ClientError, type ClientOptions, type ClientResponse, type ClientValidationError, type ClientValidator, type ClientValidatorOptions, type DataOf, type DbPatch, type DbRow, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type OwnOf, type PageResult, type PatchOf, type RelationInfo, type RowOf, type SearchIndexInfo, type ServerError, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbDeleteResult, type TDbInsertManyResult, type TDbInsertResult, type TDbUpdateResult, type TSerializedAnnotatedType, TransportError, type TypedWithRelation, type Uniquery, type UniqueryControls, type ValidatorMode, VersionMismatchError, type VersionMismatchErrorBody, encodeNavigateId, formatIdentifier, formatIdentifierField };

package/dist/index.mjs

@@ -55,6 +55,24 @@ var VersionMismatchError = class extends ClientError {
 		return this.body.currentVersion;
 	}
 };
+/**
+* Thrown by `Client` when NO server verdict was obtained: `fetch` itself
+* rejected (network down, DNS, CORS, `AbortError`, …) or a 2xx response
+* carried a body that is not JSON. Unlike {@link ClientError} — where the
+* server answered and rejected — the request's outcome is unknown: a write
+* may have committed. Reload before retrying a non-idempotent write.
+* The underlying error is the standard `cause`.
+*/
+var TransportError = class extends Error {
+	method;
+	url;
+	name = "TransportError";
+	constructor(method, url, detail, cause) {
+		super(`${method} ${url}: ${detail}`, { cause });
+		this.method = method;
+		this.url = url;
+	}
+};
 /** Thrown by `Client.action()` when the action name is not present in `/meta`. */
 var ActionNotFoundError = class extends Error {
 	action;
@@ -429,14 +447,20 @@ var Client = class {
 		return init;
 	}
 	async _send(url, init, allowEmpty) {
-		const res = await this._fetch(url, init);
+		const method = init.method ?? "GET";
+		let res;
+		try {
+			res = await this._fetch(url, init);
+		} catch (cause) {
+			throw new TransportError(method, url, describeCause(cause), cause);
+		}
 		if (!res.ok) {
 			let errorBody;
 			try {
 				errorBody = await res.json();
 			} catch {
 				errorBody = {
-					message: res.statusText,
+					message: res.statusText || `HTTP ${res.status}`,
 					statusCode: res.status
 				};
 			}
@@ -444,7 +468,11 @@ var Client = class {
 			if (errorBody.kind === "version_mismatch") throw new VersionMismatchError(res.status, errorBody);
 			throw new ClientError(res.status, errorBody);
 		}
-		if (!allowEmpty) return res.json();
+		if (!allowEmpty) try {
+			return await res.json();
+		} catch (cause) {
+			throw new TransportError(method, url, `HTTP ${res.status} body is not JSON (${describeCause(cause)})`, cause);
+		}
 		if (res.status === 204 || res.headers.get("content-length") === "0") return void 0;
 		try {
 			return await res.json();
@@ -453,6 +481,11 @@ var Client = class {
 		}
 	}
 };
+/** One-line rendering of a thrown value for a `TransportError` message. */
+function describeCause(cause) {
+	if (cause instanceof Error) return cause.message || cause.name;
+	return String(cause);
+}
 /**
 * Render a single identifier field for substitution into a navigate-URL
 * template or human-readable string. `null` / `undefined` collapse to `""`
@@ -489,4 +522,4 @@ function describeShape(value) {
 	return typeof value;
 }
 //#endregion
-export { ActionDisabledError, ActionNotFoundError, ActionUnsupportedError, Client, ClientError, VersionMismatchError, encodeNavigateId, formatIdentifier, formatIdentifierField };
+export { ActionDisabledError, ActionNotFoundError, ActionUnsupportedError, Client, ClientError, TransportError, VersionMismatchError, encodeNavigateId, formatIdentifier, formatIdentifierField };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-client",
-  "version": "0.1.128",
+  "version": "0.1.129",
   "description": "Browser-compatible HTTP client for @atscript/moost-db REST endpoints.",
   "keywords": [
     "atscript",
@@ -50,7 +50,7 @@
     "@atscript/typescript": "^0.1.92",
     "@uniqu/core": "^0.1.8",
     "unplugin-atscript": "^0.1.92",
-    "@atscript/db": "0.1.128"
+    "@atscript/db": "0.1.129"
   },
   "peerDependencies": {
     "@atscript/db": "^0.1.44",