@atscript/db-client 0.1.83 → 0.1.85

package/dist/index.cjs

@@ -40,6 +40,20 @@ var ActionDisabledError = class extends ClientError {
 		return this.body.ids;
 	}
 };
+/**
+* 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.action()` when the action name is not present in `/meta`. */
 var ActionNotFoundError = class extends Error {
 	name = "ActionNotFoundError";
@@ -381,6 +395,7 @@ var Client = class {
 				};
 			}
 			if (errorBody.name === "ActionDisabledError") throw new ActionDisabledError(res.status, errorBody);
+			if (errorBody.kind === "version_mismatch") throw new VersionMismatchError(res.status, errorBody);
 			throw new ClientError(res.status, errorBody);
 		}
 		if (!allowEmpty) return res.json();
@@ -433,6 +448,7 @@ exports.ActionNotFoundError = ActionNotFoundError;
 exports.ActionUnsupportedError = ActionUnsupportedError;
 exports.Client = Client;
 exports.ClientError = ClientError;
+exports.VersionMismatchError = VersionMismatchError;
 exports.encodeNavigateId = encodeNavigateId;
 exports.formatIdentifier = formatIdentifier;
 exports.formatIdentifierField = formatIdentifierField;

package/dist/index.d.cts

@@ -245,6 +245,29 @@ declare class ActionDisabledError extends ClientError {
   /** Present only for `'rows'`-level rejections (full list of failing IDs). */
   get ids(): Record<string, unknown>[] | undefined;
 }
+/**
+ * Wire-body shape for 409 OCC `version_mismatch` responses. Extends the base
+ * `ServerError` envelope with a `kind` discriminator and the row's current
+ * server-side version. The bridge between `@atscript/moost-db`'s server-side
+ * `_disambiguateMismatch` and this typed client-side subclass is the wire
+ * JSON body — neither package depends on the other.
+ */
+interface VersionMismatchErrorBody extends ServerError {
+  kind: "version_mismatch";
+  currentVersion: number;
+}
+/**
+ * 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.
+ */
+declare class VersionMismatchError extends ClientError {
+  name: string;
+  /** Row's current server-side version — clients refresh + retry against it. */
+  get currentVersion(): number;
+}
 /** Thrown by `Client.action()` when the action name is not present in `/meta`. */
 declare class ActionNotFoundError extends Error {
   readonly action: string;
@@ -264,4 +287,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 DataOf, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type OwnOf, type PageResult, type RelationInfo, 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, 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 DataOf, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type OwnOf, type PageResult, type RelationInfo, 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 };

package/dist/index.d.mts

@@ -245,6 +245,29 @@ declare class ActionDisabledError extends ClientError {
   /** Present only for `'rows'`-level rejections (full list of failing IDs). */
   get ids(): Record<string, unknown>[] | undefined;
 }
+/**
+ * Wire-body shape for 409 OCC `version_mismatch` responses. Extends the base
+ * `ServerError` envelope with a `kind` discriminator and the row's current
+ * server-side version. The bridge between `@atscript/moost-db`'s server-side
+ * `_disambiguateMismatch` and this typed client-side subclass is the wire
+ * JSON body — neither package depends on the other.
+ */
+interface VersionMismatchErrorBody extends ServerError {
+  kind: "version_mismatch";
+  currentVersion: number;
+}
+/**
+ * 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.
+ */
+declare class VersionMismatchError extends ClientError {
+  name: string;
+  /** Row's current server-side version — clients refresh + retry against it. */
+  get currentVersion(): number;
+}
 /** Thrown by `Client.action()` when the action name is not present in `/meta`. */
 declare class ActionNotFoundError extends Error {
   readonly action: string;
@@ -264,4 +287,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 DataOf, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type OwnOf, type PageResult, type RelationInfo, 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, 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 DataOf, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type OwnOf, type PageResult, type RelationInfo, 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 };

package/dist/index.mjs

@@ -39,6 +39,20 @@ var ActionDisabledError = class extends ClientError {
 		return this.body.ids;
 	}
 };
+/**
+* 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.action()` when the action name is not present in `/meta`. */
 var ActionNotFoundError = class extends Error {
 	name = "ActionNotFoundError";
@@ -380,6 +394,7 @@ var Client = class {
 				};
 			}
 			if (errorBody.name === "ActionDisabledError") throw new ActionDisabledError(res.status, errorBody);
+			if (errorBody.kind === "version_mismatch") throw new VersionMismatchError(res.status, errorBody);
 			throw new ClientError(res.status, errorBody);
 		}
 		if (!allowEmpty) return res.json();
@@ -427,4 +442,4 @@ function describeShape(value) {
 	return typeof value;
 }
 //#endregion
-export { ActionDisabledError, ActionNotFoundError, ActionUnsupportedError, Client, ClientError, encodeNavigateId, formatIdentifier, formatIdentifierField };
+export { ActionDisabledError, ActionNotFoundError, ActionUnsupportedError, Client, ClientError, VersionMismatchError, encodeNavigateId, formatIdentifier, formatIdentifierField };

package/package.json

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