@atscript/db-client 0.1.163 → 0.1.165

package/dist/client-error-C9Q5xCuW.cjs

@@ -0,0 +1,222 @@
+//#region src/client-error.ts
+/**
+* Error thrown by `Client` when the server responds with a non-2xx status code.
+* Captures the HTTP status and the structured error body from moost-db.
+*/
+var ClientError = class extends Error {
+	status;
+	body;
+	name = "ClientError";
+	constructor(status, body) {
+		super(body.message || `HTTP ${status}`);
+		this.status = status;
+		this.body = body;
+	}
+	/** Shortcut to structured validation/DB errors from the server. */
+	get errors() {
+		return this.body.errors ?? [];
+	}
+};
+/**
+* Thrown before the request is sent when the client-side preflight
+* (`validator` option, `ClientValidator`) rejects a write. A
+* {@link ClientError} since 0.1.165 — status `400`, `body` shaped like the
+* server's validation envelope (`{ message, statusCode: 400, errors }`) — so
+* one `instanceof ClientError` branch handles a preflight failure and the
+* server's 400 alike; `preflight` (`true`) tells them apart. The same class
+* is exported from `@atscript/db-client` and `@atscript/db-client/validator`.
+*/
+var ClientValidationError = class extends ClientError {
+	name = "ClientValidationError";
+	/** `true`: the request never left the client. */
+	preflight = true;
+	constructor(errors) {
+		const message = errors.length === 1 ? errors[0].message : `Validation failed with ${errors.length} errors`;
+		super(400, {
+			message,
+			statusCode: 400,
+			errors
+		});
+	}
+};
+/**
+* Typed marker thrown by `Client._send` when the server response body's
+* `name === 'ActionDisabledError'`. The transport / status / base body are
+* identical to a generic `ClientError`; this subclass adds typed accessors
+* so consumers can write `catch (e) { if (e instanceof ActionDisabledError) … }`
+* to access `action` / `id` / `ids` / `reason` / `reasons` without indexing
+* into `body`.
+*/
+var ActionDisabledError = class extends ClientError {
+	name = "ActionDisabledError";
+	/** The `@DbAction` name that rejected the request. */
+	get action() {
+		return this.body.action;
+	}
+	/** Present only for `'row'`-level rejections. */
+	get id() {
+		return this.body.id;
+	}
+	/** Present only for `'rows'`-level rejections (full list of failing IDs). */
+	get ids() {
+		return this.body.ids;
+	}
+	/**
+	* Human-readable reason shared by every rejected row — present only when
+	* the server's `disabled` predicate returned one. `message` already
+	* carries it.
+	*
+	* @since 0.1.141
+	*/
+	get reason() {
+		return this.body.reason;
+	}
+	/**
+	* `'rows'`-level only: per-row reasons index-aligned with {@link ids}
+	* (`null` where that row has none). Present only when at least one
+	* rejected row carries a reason.
+	*
+	* @since 0.1.141
+	*/
+	get reasons() {
+		return this.body.reasons;
+	}
+};
+/**
+* Typed marker thrown by `Client` when a query-targeted action request is
+* refused (body `name === 'ActionTargetError'`): `TARGET_INVALID` (400),
+* `TARGET_TOO_LARGE` (400, `cap`) or `TARGET_CHANGED` (409, `matched` — the
+* rows the query matches now; re-confirm and retry with that count).
+*
+* @since 0.1.147
+*/
+var ActionTargetError = class extends ClientError {
+	name = "ActionTargetError";
+	get code() {
+		return this.body.code;
+	}
+	get action() {
+		return this.body.action;
+	}
+	get matched() {
+		return this.body.matched;
+	}
+	get cap() {
+		return this.body.cap;
+	}
+};
+/**
+* Typed marker thrown by `Client._send` when the server response body's
+* `kind === 'version_mismatch'`. The transport / status / base body are
+* identical to a generic `ClientError`; this subclass adds a typed
+* `currentVersion` accessor so consumers can write
+* `catch (e) { if (e instanceof VersionMismatchError) … }` without casting.
+*/
+var VersionMismatchError = class extends ClientError {
+	name = "VersionMismatchError";
+	/** Row's current server-side version — clients refresh + retry against it. */
+	get currentVersion() {
+		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;
+	}
+	/**
+	* `true` when the request was cancelled — its `cause` is an `AbortError`
+	* (an aborted `signal`) or a `TimeoutError` (`AbortSignal.timeout`) —
+	* rather than a network failure. @since 0.1.165
+	*/
+	get aborted() {
+		const name = this.cause?.name;
+		return name === "AbortError" || name === "TimeoutError";
+	}
+};
+/** Thrown by `Client.action()` when the action name is not present in `/meta`. */
+var ActionNotFoundError = class extends Error {
+	action;
+	name = "ActionNotFoundError";
+	constructor(action) {
+		super(`Action "${action}" is not declared on this controller`);
+		this.action = action;
+	}
+};
+/**
+* Thrown by `Client.action()` for actions that cannot be invoked through
+* the client — currently `processor: 'custom'` (UI-dispatched events,
+* which the application is responsible for handling) and `processor: 'navigate'`
+* when no browser environment and no `navigate` option are configured.
+*/
+var ActionUnsupportedError = class extends Error {
+	action;
+	processor;
+	name = "ActionUnsupportedError";
+	constructor(action, processor, message) {
+		super(message);
+		this.action = action;
+		this.processor = processor;
+	}
+};
+//#endregion
+Object.defineProperty(exports, "ActionDisabledError", {
+	enumerable: true,
+	get: function() {
+		return ActionDisabledError;
+	}
+});
+Object.defineProperty(exports, "ActionNotFoundError", {
+	enumerable: true,
+	get: function() {
+		return ActionNotFoundError;
+	}
+});
+Object.defineProperty(exports, "ActionTargetError", {
+	enumerable: true,
+	get: function() {
+		return ActionTargetError;
+	}
+});
+Object.defineProperty(exports, "ActionUnsupportedError", {
+	enumerable: true,
+	get: function() {
+		return ActionUnsupportedError;
+	}
+});
+Object.defineProperty(exports, "ClientError", {
+	enumerable: true,
+	get: function() {
+		return ClientError;
+	}
+});
+Object.defineProperty(exports, "ClientValidationError", {
+	enumerable: true,
+	get: function() {
+		return ClientValidationError;
+	}
+});
+Object.defineProperty(exports, "TransportError", {
+	enumerable: true,
+	get: function() {
+		return TransportError;
+	}
+});
+Object.defineProperty(exports, "VersionMismatchError", {
+	enumerable: true,
+	get: function() {
+		return VersionMismatchError;
+	}
+});

package/dist/client-error-Dn4WeNft.mjs

@@ -0,0 +1,175 @@
+//#region src/client-error.ts
+/**
+* Error thrown by `Client` when the server responds with a non-2xx status code.
+* Captures the HTTP status and the structured error body from moost-db.
+*/
+var ClientError = class extends Error {
+	status;
+	body;
+	name = "ClientError";
+	constructor(status, body) {
+		super(body.message || `HTTP ${status}`);
+		this.status = status;
+		this.body = body;
+	}
+	/** Shortcut to structured validation/DB errors from the server. */
+	get errors() {
+		return this.body.errors ?? [];
+	}
+};
+/**
+* Thrown before the request is sent when the client-side preflight
+* (`validator` option, `ClientValidator`) rejects a write. A
+* {@link ClientError} since 0.1.165 — status `400`, `body` shaped like the
+* server's validation envelope (`{ message, statusCode: 400, errors }`) — so
+* one `instanceof ClientError` branch handles a preflight failure and the
+* server's 400 alike; `preflight` (`true`) tells them apart. The same class
+* is exported from `@atscript/db-client` and `@atscript/db-client/validator`.
+*/
+var ClientValidationError = class extends ClientError {
+	name = "ClientValidationError";
+	/** `true`: the request never left the client. */
+	preflight = true;
+	constructor(errors) {
+		const message = errors.length === 1 ? errors[0].message : `Validation failed with ${errors.length} errors`;
+		super(400, {
+			message,
+			statusCode: 400,
+			errors
+		});
+	}
+};
+/**
+* Typed marker thrown by `Client._send` when the server response body's
+* `name === 'ActionDisabledError'`. The transport / status / base body are
+* identical to a generic `ClientError`; this subclass adds typed accessors
+* so consumers can write `catch (e) { if (e instanceof ActionDisabledError) … }`
+* to access `action` / `id` / `ids` / `reason` / `reasons` without indexing
+* into `body`.
+*/
+var ActionDisabledError = class extends ClientError {
+	name = "ActionDisabledError";
+	/** The `@DbAction` name that rejected the request. */
+	get action() {
+		return this.body.action;
+	}
+	/** Present only for `'row'`-level rejections. */
+	get id() {
+		return this.body.id;
+	}
+	/** Present only for `'rows'`-level rejections (full list of failing IDs). */
+	get ids() {
+		return this.body.ids;
+	}
+	/**
+	* Human-readable reason shared by every rejected row — present only when
+	* the server's `disabled` predicate returned one. `message` already
+	* carries it.
+	*
+	* @since 0.1.141
+	*/
+	get reason() {
+		return this.body.reason;
+	}
+	/**
+	* `'rows'`-level only: per-row reasons index-aligned with {@link ids}
+	* (`null` where that row has none). Present only when at least one
+	* rejected row carries a reason.
+	*
+	* @since 0.1.141
+	*/
+	get reasons() {
+		return this.body.reasons;
+	}
+};
+/**
+* Typed marker thrown by `Client` when a query-targeted action request is
+* refused (body `name === 'ActionTargetError'`): `TARGET_INVALID` (400),
+* `TARGET_TOO_LARGE` (400, `cap`) or `TARGET_CHANGED` (409, `matched` — the
+* rows the query matches now; re-confirm and retry with that count).
+*
+* @since 0.1.147
+*/
+var ActionTargetError = class extends ClientError {
+	name = "ActionTargetError";
+	get code() {
+		return this.body.code;
+	}
+	get action() {
+		return this.body.action;
+	}
+	get matched() {
+		return this.body.matched;
+	}
+	get cap() {
+		return this.body.cap;
+	}
+};
+/**
+* Typed marker thrown by `Client._send` when the server response body's
+* `kind === 'version_mismatch'`. The transport / status / base body are
+* identical to a generic `ClientError`; this subclass adds a typed
+* `currentVersion` accessor so consumers can write
+* `catch (e) { if (e instanceof VersionMismatchError) … }` without casting.
+*/
+var VersionMismatchError = class extends ClientError {
+	name = "VersionMismatchError";
+	/** Row's current server-side version — clients refresh + retry against it. */
+	get currentVersion() {
+		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;
+	}
+	/**
+	* `true` when the request was cancelled — its `cause` is an `AbortError`
+	* (an aborted `signal`) or a `TimeoutError` (`AbortSignal.timeout`) —
+	* rather than a network failure. @since 0.1.165
+	*/
+	get aborted() {
+		const name = this.cause?.name;
+		return name === "AbortError" || name === "TimeoutError";
+	}
+};
+/** Thrown by `Client.action()` when the action name is not present in `/meta`. */
+var ActionNotFoundError = class extends Error {
+	action;
+	name = "ActionNotFoundError";
+	constructor(action) {
+		super(`Action "${action}" is not declared on this controller`);
+		this.action = action;
+	}
+};
+/**
+* Thrown by `Client.action()` for actions that cannot be invoked through
+* the client — currently `processor: 'custom'` (UI-dispatched events,
+* which the application is responsible for handling) and `processor: 'navigate'`
+* when no browser environment and no `navigate` option are configured.
+*/
+var ActionUnsupportedError = class extends Error {
+	action;
+	processor;
+	name = "ActionUnsupportedError";
+	constructor(action, processor, message) {
+		super(message);
+		this.action = action;
+		this.processor = processor;
+	}
+};
+//#endregion
+export { ClientError as a, VersionMismatchError as c, ActionUnsupportedError as i, ActionNotFoundError as n, ClientValidationError as o, ActionTargetError as r, TransportError as s, ActionDisabledError as t };